Генерация асинхронных медиа
Создавайте задания на генерацию изображений, видео или музыки и асинхронно получайте их артефакты.
Отправляйте длительные задачи по генерации медиа, не удерживая запрос на вывод открытым.
/v1/async-tasks/image-generationsТело запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
model | string | Нет | Идентификатор модели медиа. Если опущено, маршрутизация использует поведение настроенного поставщика по умолчанию. |
prompt | string | Да | Описание желаемого вывода. |
n | integer | Нет | Количество изображений от 1 до 10; по умолчанию 1. |
seed | integer | Нет | Неотрицательное детерминированное начальное значение, если поддерживается. |
| Дополнительные поля | object | Нет | Размеры и элементы управления генерацией, поддерживаемые поставщиком. Неизвестные поля верхнего уровня отклоняются; параметры, специфичные для поставщика, должны находиться в разделе provider_options или parameters. |
Запросы на видео принимают положительное значение duration_seconds до 300 и положительное целое число fps до 120. Запросы на музыку принимают duration_seconds до 1200 и требуют хотя бы одного из prompt, lyrics или title.
Жизненный цикл задачи
- Отправьте запрос на генерацию изображения, видео или музыки.
- Сохраните возвращенный идентификатор задачи.
- Опрашивайте
GET /v1/async-tasks/{task_id}, пока задача не завершится. - Загрузите вывод по подписанному URL-адресу артефакта.
URL-адреса артефактов имеют ограниченный срок действия. Сохраняйте конечный ресурс в собственном хранилище, если требуется долгосрочное хранение.
Псевдонимы совместимости
Существующие интеграции могут использовать /v1/images/generations, /v1/videos/generations и /v1/music/generations. Новые интеграции должны использовать явные маршруты /v1/async-tasks/*-generations, указанные выше.