Генерация видео
Создание задания и безопасная обработка асинхронного результата
Выбор модели и метода
Для генерации видео нужны модель и доступный маршрут видеозаданий. До интеграции уточните у поддержки GetAPI схему создания задания, проверки состояния и получения файла для выбранной модели
Наличие модели в GET /v1/models не определяет контракт её асинхронного API
Жизненный цикл задания
- Отправьте запрос создания и сохраните ID задания
- Проверяйте состояние с ограниченной частотой
- При успешном завершении получите файл способом, предусмотренным API модели
- При ошибке сохраните её описание и прекратите опрос
- При истечении клиентского срока прекратите ожидание, не создавая автоматически новое задание
Установите общий срок ожидания и максимальное число запросов статуса. Обрабатывайте неизвестное состояние отдельно, чтобы цикл не работал бесконечно
Данные интеграции
| Поле контракта | Что должно быть известно |
|---|---|
| Создание | HTTP-метод, путь, Content-Type |
| Модель | Точный ID и поддерживаемые параметры |
| Вход | Текст, изображение или видео, если поддерживается |
| Состояние | Поле статуса и все конечные значения |
| Результат | Путь получения файла или поле URL |
| Ошибка | Структура ошибки задания |
| Хранение | Срок доступности результата |
| Стоимость | Единица тарификации и влияние параметров |
Значения succeeded и completed нельзя считать взаимозаменяемыми без контракта конкретного метода. Также нельзя предполагать, что ссылка всегда находится в output[0].url
Повторные запросы
Повтор создания может создать второе платное задание. После таймаута сначала проверьте уже известный ID, если он получен
Вызов проверки статуса и создание нового задания имеют разные последствия, настройте повторы отдельно
За параметрами доступного подключения обратитесь в поддержку, указав модель и требуемый сценарий