Видео модель Doubao Seedance
- 2026.09.21 Этот сайт теперь поддерживает видео модели
- Официальная документация: https://docs.volcengine.com/docs/ark/create-video-generation-task-api
Doubao Seedance API
- 2026.09.21 Этот сайт теперь поддерживает видео модели
- Официальная документация: https://docs.volcengine.com/docs/ark/create-video-generation-task-api
- Замените официальный
baseurlhttps://ark.cn-beijing.volces.comнаhttps://api.openai-hk.com/doubao
1. Создание задачи
post https://api.openai-hk.com/doubao/api/v3/contents/generations/tasks
shell
curl --request POST \
--url https://api.openai-hk.com/doubao/api/v3/contents/generations/tasks \
--header 'Authorization: Bearer hk-your-key' \
--header 'Content-Type: application/json' \
--data '{
"model": "doubao-seedance-2-0-mini-260615",
"content": [
{
"type": "text",
"text": "Яркий и красочный рекламный стиль, главными героями являются фруктовое печенье, включая четыре вкуса: клубника, яблоко, виноград и апельсин. Клубничный вкус ссылается на @Image1. Печенье и соответствующие фрукты расположены в геометрическом массиве с сильным чувством порядка. Общая картина чистая, премиальная и ритмичная. Открытие демонстрирует фрукты, быстро устанавливающие визуальный фокус, ссылаясь на композицию @Video1, с музыкальными ударами. Затем печенье разных вкусов аккуратно расположены, переход к крупным планам, ссылаясь на динамику и движение камеры @Video2. Затем быстро возвращаемся к быстрому монтажу. Финал содержит английский текст 'One bite of crispness, a heart full of delight' с быстрым переключением по словам, сопровождаемым сильным ритмическим движением текста и стоп-кадром продукта."
},
{
"type": "image_url",
"image_url": {
"url": "https://arkdocs.tos-cn-beijing.volces.com/images/video-generation/seedance2.5_reference1.png"
},
"role": "reference_image"
},
{
"type": "video_url",
"video_url": {
"url": "https://arkdocs.tos-cn-beijing.volces.com/videos/video-generation/seedance2.5_reference2.mp4"
},
"role": "reference_video"
},
{
"type": "video_url",
"video_url": {
"url": "https://arkdocs.tos-cn-beijing.volces.com/videos/video-generation/seedance2.5_reference3.mp4"
},
"role": "reference_video"
}
],
"generate_audio": true,
"ratio": "16:9",
"duration": 15,
"resolution": "480p",
"omni_reference_task_type": "reference"
}
'curl --request POST \
--url https://api.openai-hk.com/doubao/api/v3/contents/generations/tasks \
--header 'Authorization: Bearer hk-your-key' \
--header 'Content-Type: application/json' \
--data '{
"model": "doubao-seedance-2-0-mini-260615",
"content": [
{
"type": "text",
"text": "Яркий и красочный рекламный стиль, главными героями являются фруктовое печенье, включая четыре вкуса: клубника, яблоко, виноград и апельсин. Клубничный вкус ссылается на @Image1. Печенье и соответствующие фрукты расположены в геометрическом массиве с сильным чувством порядка. Общая картина чистая, премиальная и ритмичная. Открытие демонстрирует фрукты, быстро устанавливающие визуальный фокус, ссылаясь на композицию @Video1, с музыкальными ударами. Затем печенье разных вкусов аккуратно расположены, переход к крупным планам, ссылаясь на динамику и движение камеры @Video2. Затем быстро возвращаемся к быстрому монтажу. Финал содержит английский текст 'One bite of crispness, a heart full of delight' с быстрым переключением по словам, сопровождаемым сильным ритмическим движением текста и стоп-кадром продукта."
},
{
"type": "image_url",
"image_url": {
"url": "https://arkdocs.tos-cn-beijing.volces.com/images/video-generation/seedance2.5_reference1.png"
},
"role": "reference_image"
},
{
"type": "video_url",
"video_url": {
"url": "https://arkdocs.tos-cn-beijing.volces.com/videos/video-generation/seedance2.5_reference2.mp4"
},
"role": "reference_video"
},
{
"type": "video_url",
"video_url": {
"url": "https://arkdocs.tos-cn-beijing.volces.com/videos/video-generation/seedance2.5_reference3.mp4"
},
"role": "reference_video"
}
],
"generate_audio": true,
"ratio": "16:9",
"duration": 15,
"resolution": "480p",
"omni_reference_task_type": "reference"
}
'- Возвращает task_id
json
{
"id": "task_6esMYNTJqw6h763PeafCp8N92fVY9Jic"
}{
"id": "task_6esMYNTJqw6h763PeafCp8N92fVY9Jic"
}2. Основные параметры запроса
| Поле | Обязательно | Описание |
|---|---|---|
model | Да | Имя модели из таблицы выше |
content | Да | Промпт + массив справочных материалов, см. ниже |
duration | Нет | Длительность (секунды) |
resolution | Нет | Разрешение, например 480p / 720p |
ratio | Нет | Соотношение сторон, например 16:9 (псевдоним aspect_ratio) |
generate_audio | Нет | Генерировать ли аудио |
Элементы массива content:
type | Поле материала | role | Описание |
|---|---|---|---|
text | text | — | Промпт. Берется первый непустой текст |
image_url | image_url.url | reference_image (по умолчанию) | Справочное изображение, соответствует @Image1, @Image2… |
image_url | image_url.url | first_frame / last_frame | Первый/последний кадр, не учитывается в нумерации @ImageN |
video_url | video_url.url | reference_video | Справочное видео, соответствует @Video1, @Video2… |
audio_url | audio_url.url | reference_audio | Справочное аудио |
Правило нумерации: порядок — это семантика.
@Image1всегда является первым справочным изображением в массиве,@Video1— первым справочным видео—нумерация отдельно по роли, начиная с 1. Неправильный порядок не вызовет ошибку, но отрисует видео, отличающееся от вашего описания, и все равно возьмет плату.
3. Запрос задачи
get https://api.openai-hk.com/doubao/api/v3/contents/generations/tasks/{taskId}
shell
curl --request GET \
--url https://api.openai-hk.com/doubao/api/v3/contents/generations/tasks/task_6esMYNTJqw6h763PeafCp8N92fVY9Jic \
--header 'Authorization: Bearer hk-your-key' \
--header 'Content-Type: application/json'curl --request GET \
--url https://api.openai-hk.com/doubao/api/v3/contents/generations/tasks/task_6esMYNTJqw6h763PeafCp8N92fVY9Jic \
--header 'Authorization: Bearer hk-your-key' \
--header 'Content-Type: application/json'- Успешный ответ
json
{
"content": {
"video_url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-2-0-mini/02178996062422000000000000000000000ffffac1446bb35c08d.mp4?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=AKLTYWJkZTExNjA1ZDUyNDc3YzhjNTM5OGIyNjBhNDcyOTQ%2F20260921%2Fcn-beijing%2Ftos%2Frequest&X-Tos-Date=20260921T031836Z&X-Tos-Expires=86400&X-Tos-Signature=601f68beb9da380599efea3817ce91612be94beabb085848281fa1ba9047b66c&X-Tos-SignedHeaders=host"
},
"created_at": 1789960624,
"draft": false,
"duration": 4,
"execution_expires_after": 172800,
"framespersecond": 24,
"generate_audio": true,
"id": "task_6esMYNTJqw6h763PeafCp8N92fVY9Jic",
"model": "doubao-seedance-2-0-mini-260615-max",
"origin_id": "cgt-20260921111703-hsk6d",
"output_format": "mp4",
"priority": 0,
"ratio": "16:9",
"resolution": "480p",
"seed": 47550,
"service_tier": "default",
"status": "succeeded",
"updated_at": 1789960725,
"usage": {
"completion_tokens": 40594,
"total_tokens": 40594
}
}{
"content": {
"video_url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-2-0-mini/02178996062422000000000000000000000ffffac1446bb35c08d.mp4?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=AKLTYWJkZTExNjA1ZDUyNDc3YzhjNTM5OGIyNjBhNDcyOTQ%2F20260921%2Fcn-beijing%2Ftos%2Frequest&X-Tos-Date=20260921T031836Z&X-Tos-Expires=86400&X-Tos-Signature=601f68beb9da380599efea3817ce91612be94beabb085848281fa1ba9047b66c&X-Tos-SignedHeaders=host"
},
"created_at": 1789960624,
"draft": false,
"duration": 4,
"execution_expires_after": 172800,
"framespersecond": 24,
"generate_audio": true,
"id": "task_6esMYNTJqw6h763PeafCp8N92fVY9Jic",
"model": "doubao-seedance-2-0-mini-260615-max",
"origin_id": "cgt-20260921111703-hsk6d",
"output_format": "mp4",
"priority": 0,
"ratio": "16:9",
"resolution": "480p",
"seed": 47550,
"service_tier": "default",
"status": "succeeded",
"updated_at": 1789960725,
"usage": {
"completion_tokens": 40594,
"total_tokens": 40594
}
}- Ответ с ошибкой
json
{
"error": {
"code": "invalid_request",
"message": "Upstream submit failed (400): {\"code\":\"fail_to_fetch_task\",\"message\":\"{\\\"error\\\":{\\\"code\\\":\\\"InvalidParameter\\\",\\\"message\\\":\\\"The parameter `output_format` specified in the request is not valid: the specified model does not support this output_format"
},
"id": "task_6CyBKW7HUIRQGEB45CQ8r1a0gQwugHDF",
"model": "doubao-seedance-2-0-mini-260615-max",
"status": "failed"
}{
"error": {
"code": "invalid_request",
"message": "Upstream submit failed (400): {\"code\":\"fail_to_fetch_task\",\"message\":\"{\\\"error\\\":{\\\"code\\\":\\\"InvalidParameter\\\",\\\"message\\\":\\\"The parameter `output_format` specified in the request is not valid: the specified model does not support this output_format"
},
"id": "task_6CyBKW7HUIRQGEB45CQ8r1a0gQwugHDF",
"model": "doubao-seedance-2-0-mini-260615-max",
"status": "failed"
}4. Параметры ответа
| Поле | Тип | Описание |
|---|---|---|
| id | string | task_id |
| model | string | Имя модели |
| content.video_url | string | URL результата видео |
| usage | object | Информация об использовании для выставления счета |
| status | string | Статус: queued running succeeded failed |
| error | string | Сообщение об ошибке |
Биллинг
- Счет выставляется на основе
usage.total_tokens - Цена зависит от
наличия справочного видео,разрешения,модели - Единица цены: CNY за миллион токенов
- Формула расчета цены: usage.total_tokens × цена
- С видео цена за единицу < без видео, но с видео
usage.total_tokensвыше, поэтому общая цена с видео выше
| Модель | С видео | Без видео |
|---|---|---|
| doubao-seedance-2-0-mini-260615 все разрешения | 14 | 23 |
| doubao-seedance-2-0-fast-260128 все разрешения | 22 | 37 |
| doubao-seedance-2-0-260128 480P/720P | 28 | 46 |
| doubao-seedance-2-0-260128 1080P | 31 | 51 |
| doubao-seedance-2-0-260128 4K | 16 | 26 |
| doubao-seedance-2-5-260628 480P/720P | 42 | 70 |
| doubao-seedance-2-5-260628 1080P | 46 | 77 |
OpenAi-HK