Create video generation task API (doubao-2.0)
Seedance 2.0 official video generation protocol (/api/v3/contents/generations/tasks). Also registered on the seedance router; coexists with legacy /volc/v1/ Doubao routes. content items differ by type: text needs only…
POST
/api/v3/contents/generations/tasksBody Parametersapplication/json
content* array
Content array; by `type`: `text` needs only `text`; `image_url`/`video_url`/`audio_url` need matching URL and `role`.
items object object
duration integer
Duration (seconds or platform-defined unit)
generate_audio boolean
Whether to generate audio
model* string
Model name / model ID
ratio string
Aspect ratio or resolution ratio
watermark boolean
Whether to add a watermark
Responses
200 application/json
response-200 object
400 Bad request or validation failed application/json
response-400 object
properties error* object
401 Missing or invalid API Key application/json
response-401 object
1{
2"content": [
3{
4"text": "全程使用视频1的第一视角构图,全程使用音频1作为背景音乐。第一人称视角果茶宣传广告,seedance牌「苹苹安安」苹果果茶限定款;首帧为图片1,你的手摘下一颗带晨露的阿克苏红苹果,轻脆的苹果碰撞声;2-4 秒:快速切镜,你的手将苹果块投入雪克杯,加入冰块与茶底,用力摇晃,冰块碰撞声与摇晃声卡点轻快鼓点,背景音:「鲜切现摇」;4-6 秒:第一人称成品特写,分层果茶倒入透明杯,你的手轻挤奶盖在顶部铺展,在杯身贴上粉红包标,镜头拉近看奶盖与果茶的分层纹理;6-8 秒:第一人称手持举杯,你将图片2中的果茶举到镜头前(模拟递到观众面前的视角),杯身标签清晰可见,背景音「来一口鲜爽」,尾帧定格为图片2。背景声音统一为女生音色。",
5"type": "text"
6},
7{
8"image_url": {
9"url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic1.jpg"
10},
11"role": "reference_image",
12"type": "image_url"
13},
14{
15"image_url": {
16"url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic2.jpg"
17},
18"role": "reference_image",
19"type": "image_url"
20},
21{
22"role": "reference_video",
23"type": "video_url",
24"video_url": {
25"url": "https://pro.filesystem.site/cdn/20260403/0e80a635b859e7716671a40d836135.mp4"
26}
27},
28{
29"audio_url": {
30"url": "https://ark-project.tos-cn-beijing.volces.com/doc_audio/r2v_tea_audio1.mp3"
31},
32"role": "reference_audio",
33"type": "audio_url"
34}
35],
36"duration": 11,
37"generate_audio": true,
38"model": "doubao-seedance-2-0-260128",
39"ratio": "21:9",
40"watermark": false
41}
1curl -X POST "https://api.digislash.com/api/v3/contents/generations/tasks" \
2-H "Authorization: Bearer <API Key>" \
3-H "Content-Type: application/json" \
4-d '{
5"content": [
6{
7"text": "全程使用视频1的第一视角构图,全程使用音频1作为背景音乐。第一人称视角果茶宣传广告,seedance牌「苹苹安安」苹果果茶限定款;首帧为图片1,你的手摘下一颗带晨露的阿克苏红苹果,轻脆的苹果碰撞声;2-4 秒:快速切镜,你的手将苹果块投入雪克杯,加入冰块与茶底,用力摇晃,冰块碰撞声与摇晃声卡点轻快鼓点,背景音:「鲜切现摇」;4-6 秒:第一人称成品特写,分层果茶倒入透明杯,你的手轻挤奶盖在顶部铺展,在杯身贴上粉红包标,镜头拉近看奶盖与果茶的分层纹理;6-8 秒:第一人称手持举杯,你将图片2中的果茶举到镜头前(模拟递到观众面前的视角),杯身标签清晰可见,背景音「来一口鲜爽」,尾帧定格为图片2。背景声音统一为女生音色。",
8"type": "text"
9},
10{
11"image_url": {
12"url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic1.jpg"
13},
14"role": "reference_image",
15"type": "image_url"
16},
17{
18"image_url": {
19"url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic2.jpg"
20},
21"role": "reference_image",
22"type": "image_url"
23},
24{
25"role": "reference_video",
26"type": "video_url",
27"video_url": {
28"url": "https://pro.filesystem.site/cdn/20260403/0e80a635b859e7716671a40d836135.mp4"
29}
30},
31{
32"audio_url": {
33"url": "https://ark-project.tos-cn-beijing.volces.com/doc_audio/r2v_tea_audio1.mp3"
34},
35"role": "reference_audio",
36"type": "audio_url"
37}
38],
39"duration": 11,
40"generate_audio": true,
41"model": "doubao-seedance-2-0-260128",
42"ratio": "21:9",
43"watermark": false
44}'
1▼{
2"code": 0,
3▼"data": {
4"task_id": "task_example_001"
5},
6"message": "success"
7}
