Генерация видео и управление медиаресурсами
Создавайте видео с помощью моделей Kling v4 и Seedance и используйте авторизованные медиаресурсы.
Отправляйте задачи генерации видео и управляйте авторизованными медиаресурсами через нативные конечные точки видео.
POST
/v1/videosТело запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
prompt | string | Да | Текстовое описание желаемой сцены и движений камеры в видео. |
model | string | Нет | Идентификатор модели видео, например kling-v4 или doubao-seedance-2-0-260128. |
duration_seconds | number | Нет | Длительность видео в секундах (положительное число до 300 или псевдоним duration). |
| Additional fields | object | Нет | Дополнительные параметры видео (resolution, aspect_ratio, first_frame_url, last_frame_url) прозрачно передаются в модель. |
Авторизованные ресурсы Seedance
POST
/v1/seedance/assetsGET
/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.