Генерация видео и управление медиаресурсами

Создавайте видео с помощью моделей Kling v4 и Seedance и используйте авторизованные медиаресурсы.

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

POST/v1/videos

Тело запроса

ПолеТипОбязательноОписание
promptstringДаТекстовое описание желаемой сцены и движений камеры в видео.
modelstringНетИдентификатор модели видео, например kling-v4 или doubao-seedance-2-0-260128.
duration_secondsnumberНетДлительность видео в секундах (положительное число до 300 или псевдоним duration).
Additional fieldsobjectНетДополнительные параметры видео (resolution, aspect_ratio, first_frame_url, last_frame_url) прозрачно передаются в модель.

Авторизованные ресурсы Seedance

POST/v1/seedance/assets
GET/v1/seedance/assets/{asset_id}
  • Регистрация медиаресурсов: Отправьте POST /v1/seedance/assets (operationId: seedance_assets.create) с JSON, содержащим обязательные поля sourceUrl и assetType (image или video), а также необязательное displayName.
  • Ссылки по URI: Ссылайтесь на зарегистрированные медиафайлы напрямую через asset://{asset_id} в URL кадров или параметрах.
  • Изоляция арендаторов: Ресурсы изолированы в текущей библиотеке ресурсов арендатора и проверяются в вышестоящем хранилище.

Статус задачи и скачивание

GET/v1/videos/{task_id}
  • Опрос статуса: Запрашивайте статус задачи через GET /v1/videos/{task_id} (operationId: legacy_media.video.get), поддерживающий 9 статусов: queued, submitting, submitted, running, ingesting_artifacts, cancel_requested, completed, failed и cancelled.
  • Скачивание результатов: Скачивайте готовый бинарный видеофайл через GET /v1/videos/{task_id}/content.
  • Поддержка Kling v4: Полная поддержка режимов текст-в-видео, первого кадра из изображения и переходов в финальный кадр.

Псевдонимы совместимости

  • Устаревший псевдоним: POST /openai/v1/videos является псевдонимом POST /v1/videos (legacy_media.video.create.alias) с идентичной структурой.
  • Устаревший маршрут задач: POST /v1/videos/generations принимает полезную нагрузку формата CreateVideoGenerationRequest.
  • Единый асинхронный конвейер: POST /v1/async-tasks/video-generations предоставляет стандартный контракт жизненного цикла задач v4.