Seedance
Seedance — семейство моделей для генерации видео через CDNvideo AI Hub media API.
Base URL
https://api.cdnvideo.ru/app/aihub-router/v1/media
Для работы используется обычный ключ AI Hub в заголовке Authorization. Модель для маршрутизации передаётся в X-Model:
Authorization: Bearer ${AIHUB_API_KEY}
X-Model: seedance-1-5-pro
Для seedance-1-5-pro в теле запроса указывайте model: doubao-seedance-1-5-pro-251215.
Асинхронная обработка
Seedance возвращает id задачи, а не готовое видео. После создания задачи опрашивайте GET /seedance/contents/generations/tasks/{id} до статуса succeeded, затем заберите URL из content.video_url.
Создание video-задачи
POST /seedance/contents/generations/tasks
Метод создаёт задачу генерации видео. seedance-1-5-pro поддерживает text-to-video, image-to-video по первому кадру, first/last frames, draft mode и генерацию аудио.
Параметры запроса
| Поле | Тип | Обязательное | По умолчанию | Описание |
|---|---|---|---|---|
model |
string |
Да | — | ID backend-модели. Для seedance-1-5-pro используйте doubao-seedance-1-5-pro-251215. |
content |
array<object> |
Да | — | Список входного контента: текст, изображения или draft task. |
content[].type |
string |
Да | — | Тип элемента: text, image_url, draft_task. |
content[].text |
string |
Для type: text |
— | Текстовый промпт. Поддерживает китайский и английский; рекомендуется не превышать 500 слов. Параметры можно добавлять в конец промпта через --parameter. |
content[].image_url |
object |
Для type: image_url |
— | Объект изображения. |
content[].image_url.url |
string |
Для type: image_url |
— | URL изображения или Base64 Data URL вида data:image/<format>;base64,<data>. Формат в префиксе должен быть в нижнем регистре. |
content[].role |
string |
Для first/last frames | — | Роль изображения: first_frame, last_frame. Для одного первого кадра можно не указывать или указать first_frame. |
content[].draft_task |
object |
Для type: draft_task |
— | Объект draft task ID для генерации финального видео на основе черновика. |
content[].draft_task.id |
string |
Для type: draft_task |
— | ID успешно созданной draft-задачи. |
callback_url |
string |
Нет | — | URL для callback-уведомлений при изменении статуса задачи. |
return_last_frame |
boolean |
Нет | false |
Вернуть последний кадр сгенерированного видео. Для draft mode не поддерживается. |
service_tier |
string |
Нет | default |
Уровень сервиса: default. Значение flex описано в upstream API, но сейчас недоступно. |
execution_expires_after |
integer |
Нет | 172800 |
Время жизни выполнения в секундах. Диапазон: 3600–259200. |
generate_audio |
boolean |
Нет | true |
Генерировать синхронизированное аудио: речь, эффекты и музыку. Для лучшего результата реплики помещайте в двойные кавычки. |
draft |
boolean |
Нет | false |
Включает draft mode для быстрого preview. Поддерживает только 480p, не поддерживает return_last_frame и offline/flex режим. |
Параметры в prompt
Часть настроек можно передавать прямо в тексте промпта, например --ratio 16:9, --dur 5, --rs 720p, --seed 12345, --wm true. Для seedance-1-5-pro параметр frames не поддерживается.
Text-to-video
curl https://api.cdnvideo.ru/app/aihub-router/v1/media/seedance/contents/generations/tasks \
-H "Authorization: Bearer ${AIHUB_API_KEY}" \
-H "Content-Type: application/json" \
-H "X-Model: seedance-1-5-pro" \
-d '{
"model": "doubao-seedance-1-5-pro-251215",
"content": [
{
"type": "text",
"text": "Multiple shots. A detective enters a dimly lit room. He checks the clues on the table and picks up an item. The camera pans to him thinking. --ratio 16:9"
}
],
"generate_audio": true
}'
Ответ
{
"id": "cgt-2025******-****"
}
Image-to-video: первый кадр
Для генерации по первому кадру передайте один элемент image_url. Роль можно не указывать или задать first_frame.
curl https://api.cdnvideo.ru/app/aihub-router/v1/media/seedance/contents/generations/tasks \
-H "Authorization: Bearer ${AIHUB_API_KEY}" \
-H "Content-Type: application/json" \
-H "X-Model: seedance-1-5-pro" \
-d '{
"model": "doubao-seedance-1-5-pro-251215",
"content": [
{
"type": "text",
"text": "A girl is holding a fox. The girl opens her eyes, looks gently at the camera, and the fox cuddles up friendly. The camera slowly pulls back. --ratio adaptive --dur 5"
},
{
"type": "image_url",
"image_url": {
"url": "https://example.com/first-frame.png"
},
"role": "first_frame"
}
]
}'
First and last frames
Для генерации перехода между первым и последним кадром передайте два изображения с ролями first_frame и last_frame.
curl https://api.cdnvideo.ru/app/aihub-router/v1/media/seedance/contents/generations/tasks \
-H "Authorization: Bearer ${AIHUB_API_KEY}" \
-H "Content-Type: application/json" \
-H "X-Model: seedance-1-5-pro" \
-d '{
"model": "doubao-seedance-1-5-pro-251215",
"content": [
{
"type": "text",
"text": "A blue-green mythical bird transforms into a human form --rs 720p --dur 5 --cf false"
},
{
"type": "image_url",
"image_url": {"url": "https://example.com/first-frame.png"},
"role": "first_frame"
},
{
"type": "image_url",
"image_url": {"url": "https://example.com/last-frame.png"},
"role": "last_frame"
}
],
"return_last_frame": true
}'
Draft mode
Draft mode позволяет быстро проверить структуру сцены, монтаж, действия объектов и соответствие промпту. Черновик дешевле обычного видео, но поддерживает только 480p, не поддерживает return_last_frame и flex.
Шаг 1. Создать draft
curl https://api.cdnvideo.ru/app/aihub-router/v1/media/seedance/contents/generations/tasks \
-H "Authorization: Bearer ${AIHUB_API_KEY}" \
-H "Content-Type: application/json" \
-H "X-Model: seedance-1-5-pro" \
-d '{
"model": "doubao-seedance-1-5-pro-251215",
"content": [
{
"type": "text",
"text": "A girl is holding a fox. The girl opens her eyes, looks gently at the camera, and the fox cuddles up friendly."
},
{
"type": "image_url",
"image_url": {"url": "https://example.com/first-frame.png"}
}
],
"seed": 20,
"duration": 6,
"draft": true
}'
Шаг 2. Создать финальное видео по draft
После успешной генерации draft передайте его ID как draft_task.
curl https://api.cdnvideo.ru/app/aihub-router/v1/media/seedance/contents/generations/tasks \
-H "Authorization: Bearer ${AIHUB_API_KEY}" \
-H "Content-Type: application/json" \
-H "X-Model: seedance-1-5-pro" \
-d '{
"model": "doubao-seedance-1-5-pro-251215",
"content": [
{
"type": "draft_task",
"draft_task": {"id": "cgt-2026******-AAAAA"}
}
],
"watermark": false,
"resolution": "720p",
"return_last_frame": true,
"service_tier": "default"
}'
Получение статуса задачи
GET /seedance/contents/generations/tasks/{id}
Метод возвращает статус задачи и URL готового видео при успешном завершении.
Path-параметры
| Параметр | Тип | Обязательное | Описание |
|---|---|---|---|
id |
string |
Да | ID задачи из ответа создания, например cgt-2025******-****. |
Пример curl
curl https://api.cdnvideo.ru/app/aihub-router/v1/media/seedance/contents/generations/tasks/cgt-2025******-**** \
-H "Authorization: Bearer ${AIHUB_API_KEY}" \
-H "Content-Type: application/json" \
-H "X-Model: seedance-1-5-pro"
Ответ завершённой задачи
{
"id": "cgt-2025******-****",
"model": "doubao-seedance-1-5-pro-251215",
"status": "succeeded",
"content": {
"video_url": "https://example.com/generated-video.mp4"
},
"seed": 10,
"resolution": "720p",
"duration": 5,
"ratio": "16:9",
"framespersecond": 24,
"usage": {
"completion_tokens": 108900,
"total_tokens": 108900
},
"created_at": 1743414619,
"updated_at": 1743414673
}
Статусы задачи
| Статус | Описание |
|---|---|
queued |
Задача поставлена в очередь. |
running |
Задача выполняется. |
succeeded |
Задача успешно завершена. |
failed |
Задача завершилась ошибкой. |
cancelled |
Задача отменена или удалена. |
Список задач
GET /seedance/contents/generations/tasks?page_num={page_num}&page_size={page_size}&filter.status={status}&filter.task_ids={task_ids}&filter.model={model}
Метод возвращает список задач с фильтрами по статусу, ID и модели.
Пример curl
curl "https://api.cdnvideo.ru/app/aihub-router/v1/media/seedance/contents/generations/tasks?page_size=3&filter.status=succeeded" \
-H "Authorization: Bearer ${AIHUB_API_KEY}" \
-H "Content-Type: application/json" \
-H "X-Model: seedance-1-5-pro"
Отмена или удаление задачи
DELETE /seedance/contents/generations/tasks/{id}
Метод отменяет или удаляет video-задачу.
Пример curl
curl -X DELETE https://api.cdnvideo.ru/app/aihub-router/v1/media/seedance/contents/generations/tasks/cgt-2025******-**** \
-H "Authorization: Bearer ${AIHUB_API_KEY}" \
-H "Content-Type: application/json" \
-H "X-Model: seedance-1-5-pro"
Типовой сценарий
- Создайте задачу через
POST /seedance/contents/generations/tasks. - Сохраните
idиз ответа. - Опрашивайте
GET /seedance/contents/generations/tasks/{id}до статусаsucceeded. - Скачайте видео по
content.video_url.
Ограничения
- Для
seedance-1-5-proуказывайтеX-Model: seedance-1-5-proиmodel: doubao-seedance-1-5-pro-251215. - Рекомендуемая длина prompt — до
500слов. seedance-1-5-proне поддерживает параметрframes.generate_audioподдерживается вseedance-1-5-pro; по умолчанию включён.- Draft mode поддерживает только
480pи не поддерживаетreturn_last_frame. service_tier: flexописан в upstream API, но сейчас недоступен.