Перейти к основному контенту

Глоссарий разработчика

Разберитесь в API до начала интеграции.

Практические определения помогут выбрать модель, обработать статусы, проверить callback, оценить использование и защитить файлы пользователей.

01

Асинхронный API генерации

Определение

API принимает медиазапрос, возвращает постоянный taskId и завершает работу вне исходного HTTP-запроса.

Заметка по реализации

Сохраните taskId до polling или Webhook. queued и running означают выполнение; succeeded, failed и expired — конечные состояния. Принятую задачу нельзя отменить.

Связанная страница →
02

Ключ идемпотентности

Определение

Клиентский идентификатор, который связывает повторы с одной логической задачей и не создаёт двойную оплачиваемую работу.

Заметка по реализации

Используйте тот же ключ только для того же проверенного запроса, храните с задачей и возвращайте исходный результат при повторе.

Связанная страница →
03

Подпись Webhook

Определение

Криптографическое значение для проверки, что callback пришёл от API и не был изменён.

Заметка по реализации

Проверяйте исходное тело, отклоняйте старые метки времени и дедуплицируйте eventId до изменения задачи или оплаты.

Связанная страница →
04

Схема модели

Определение

Машиночитаемая спецификация с полями, типами, лимитами, значениями по умолчанию и формой результата.

Заметка по реализации

Создавайте формы и серверную валидацию из опубликованной схемы и фиксируйте использованную версию для каждой задачи.

Связанная страница →
05

Референсное изображение

Определение

Входное изображение, которое задаёт идентичность, композицию, стиль или движение при генерации.

Заметка по реализации

Фиксируйте источник и согласие, проверяйте формат; референс не даёт разрешения воспроизводить реального человека.

Связанная страница →
06

Оплата по фактическому использованию

Определение

Стоимость зависит от реального объёма использования. Для каждой модели указана своя единица: изображение, секунда результата, мегапиксель, токен или запрос.

Заметка по реализации

До запуска показывайте единицу и оценку стоимости; минимальная плата, длительность и число результатов могут изменить итог.

Связанная страница →
07

Модель ИИ с ослабленной фильтрацией контента

Определение

Опция отдельных моделей с меньшей фильтрацией. Метка описывает продукт и не является одобрением платформы.

Заметка по реализации

До отправки реализуйте в своём приложении проверки возраста, согласия, реальных лиц и юрисдикции, необходимые для ваших пользователей.

Связанная страница →

Готовы подключить модель?

Проверьте входные данные, примеры и текущие цены, а перед запуском посмотрите оценку для своих параметров.