видео

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

Запрос

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

Authorization: Bearer KITTA_API_KEY

Используйте только пути к конечным точкам, возвращаемые GET /api/openapi.json. Не копируйте пути из других развертываний в зарубежные клиенты.

Ответ

Ответы на видеозадачи обычно сначала возвращают идентификатор и статус задачи, а затем URL-адрес результата видео после завершения. Храните идентификатор задачи и исходный идентификатор проекта вместе, поскольку создание видео может пережить сеанс браузера.

Выставление счетов и кредиты

Видеозадания могут стоить дорого. Принудительное подтверждение пользователя для длительной продолжительности, высокого разрешения или пакетной генерации. Проверьте Профиль перед созданием пакетов и приостановите очередь из-за недостаточного количества кредитов.

Ошибки

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

Текущие публичные конечные точки

Получайте проверенные модели через GET /api/open/v1/media/models?mediaType=video, создавайте задания через POST /api/open/v1/media/videos/jobs и проверяйте их через GET /api/open/v1/media/videos/jobs/{jobId}. Для создания обязателен уникальный заголовок Idempotency-Key: повтор с тем же ключом возвращает первый ответ без повторного задания и списания. Используется квота API, а не кредиты сайта; при сбоях создания, сохранения, асинхронной обработки или тайм-ауте квота возвращается идемпотентно.