创建视频生成任务,支持 Seedance 系列模型的文本生成视频、首尾帧图生视频、参考素材生成视频等模式。
| 参数名 | 必填 | 说明 | 示例 |
|---|---|---|---|
| Authorization | 是 | 鉴权 Token。格式:Bearer API_KEY | Bearer sk-123456... |
| Content-Type | 是 | 内容类型。固定为 application/json | application/json |
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| model | string | 是 | 模型名称 |
| content | array | 是 | 视频内容描述(文本、图片、音频或视频) |
| duration | int | 是 | 视频时长(秒) |
| resolution | string | 是 | 分辨率,如 "480p"、"720p"、"1080p" |
| ratio | string | 是 | 宽高比,如 "16:9"、"9:16" |
| timeout | int | 否 | 最大超时时间(秒),min:3600,max:172800 |
| watermark | bool | 否 | 是否添加水印,默认添加 |
| provider_specific | object | 否 | 厂商特定参数(JSON 对象) |
content 数组用于描述视频内容,支持文本、图片、音频、视频四种类型。每个元素包含以下字段:
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| type | string | 是 | 内容类型: "text"、"image"、"audio"、"video" |
| text | string | 否 | 当 type 为 "text" 时,填写文本内容(提示词) |
| url | string | 否 | 当 type 为 "image" 时,填写图片 URL(支持 http/https 链接及 data URL) |
| role | string | 否 | 当 type 为 "image" 时,指定图片作用;Seedance-Pro-1.5 使用 first_frame、last_frame,Seedance-2.0 与 Seedance-2.0-Fast 使用 first_frame、last_frame 或 reference |
| audio_url | string | 否 | 当 type 为 "audio" 时,填写音频 URL |
| video_url | string | 否 | 当 type 为 "video" 时,填写视频 URL |
| 模型名 | 支持参数说明 | 不支持参数说明 |
|---|---|---|
| Seedance-Pro-1.5 | 1. ratio可选:16:9, 9:16 2. resolution可选:720p, 1080p 3. duration可选:2至12秒之间的整数 4. content支持:text(可选,最多 1 条)、image(可选,最多 2 张,仅支持 first_frame 和 last_frame;仅传尾帧时不合法) 5. content 至少需要 text 或 image 之一 6. provider_specific可选:generate_audio(bool,默认 true)、camera_fixed(bool,默认 false) | 不支持 reference 图片,不支持 audio,不支持 video |
| Seedance-2.0 | 1. ratio可选:16:9, 4:3, 1:1, 3:4, 9:16 2. resolution可选:480p, 720p 3. duration可选:4至15秒之间的整数 4. content支持两种模式: a. 首尾帧模式:text(可选,最多 1 条)+ image(仅支持 first_frame / last_frame,首帧必传,尾帧可选),且不能与 reference/audio/video 混用 b. 参考素材模式:text(可选,最多 1 条)+ reference 图片(最多 9 张)+ audio(最多 3 条)+ video(最多 3 条) 5. 仅传 audio 不合法,必须至少搭配 image 或 video 6. provider_specific可选:generate_audio(bool,默认 true) | 不支持在同一请求中混用首尾帧和参考素材,不支持 camera_fixed |
| Seedance-2.0-Fast | 1. ratio可选:16:9, 4:3, 1:1, 3:4, 9:16 2. resolution可选:480p, 720p 3. duration可选:4至15秒之间的整数 4. content支持两种模式: a. 首尾帧模式:text(可选,最多 1 条)+ image(仅支持 first_frame / last_frame,首帧必传,尾帧可选),且不能与 reference/audio/video 混用 b. 参考素材模式:text(可选,最多 1 条)+ reference 图片(最多 9 张)+ audio(最多 3 条)+ video(最多 3 条) 5. 仅传 audio 不合法,必须至少搭配 image 或 video 6. provider_specific可选:generate_audio(bool,默认 true) | 不支持在同一请求中混用首尾帧和参考素材,不支持 camera_fixed |
Seedance-Pro-1.5 — 文本生成视频
curl -X POST "https://api.senseaudio.cn/v1/video/create" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "Seedance-Pro-1.5",
"content": [
{"type": "text", "text": "一只可爱的小猫在花园里玩耍"}
],
"resolution": "1080p",
"ratio": "16:9",
"duration": 8,
"watermark": false,
"provider_specific": {"generate_audio": true, "camera_fixed": false}
}'Seedance-Pro-1.5 — 首帧图生视频
curl -X POST "https://api.senseaudio.cn/v1/video/create" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "Seedance-Pro-1.5",
"content": [
{"type": "text", "text": "一只可爱的小猫在花园里玩耍"},
{"type": "image", "url": "https://example.com/first.jpg", "role": "first_frame"}
],
"resolution": "1080p",
"ratio": "16:9",
"duration": 8,
"watermark": false,
"provider_specific": {"generate_audio": false, "camera_fixed": true}
}'Seedance-Pro-1.5 — 首尾帧图生视频
curl -X POST "https://api.senseaudio.cn/v1/video/create" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "Seedance-Pro-1.5",
"content": [
{"type": "text", "text": "一只可爱的小猫在花园里玩耍"},
{"type": "image", "url": "https://example.com/first.jpg", "role": "first_frame"},
{"type": "image", "url": "https://example.com/last.jpg", "role": "last_frame"}
],
"resolution": "1080p",
"ratio": "16:9",
"duration": 8,
"watermark": false,
"provider_specific": {"generate_audio": false, "camera_fixed": true}
}'Seedance-2.0 — 纯文本生成视频
curl -X POST "https://api.senseaudio.cn/v1/video/create" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "Seedance-2.0",
"content": [
{"type": "text", "text": "黄昏海边,海浪轻轻拍打礁石,镜头缓慢推进"}
],
"resolution": "720p",
"ratio": "16:9",
"duration": 10,
"watermark": true,
"provider_specific": {"generate_audio": true}
}'Seedance-2.0 — 首帧图生视频
curl -X POST "https://api.senseaudio.cn/v1/video/create" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "Seedance-2.0",
"content": [
{"type": "text", "text": "镜头从女孩侧脸缓慢推进,发丝被微风吹动"},
{"type": "image", "url": "https://example.com/first.jpg", "role": "first_frame"}
],
"resolution": "720p",
"ratio": "9:16",
"duration": 5,
"watermark": false,
"provider_specific": {"generate_audio": false}
}'Seedance-2.0 — 首尾帧图生视频
curl -X POST "https://api.senseaudio.cn/v1/video/create" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "Seedance-2.0",
"content": [
{"type": "text", "text": "镜头从街头咖啡店门口推进到室内,最后停在窗边座位"},
{"type": "image", "url": "https://example.com/first.jpg", "role": "first_frame"},
{"type": "image", "url": "https://example.com/last.jpg", "role": "last_frame"}
],
"resolution": "720p",
"ratio": "16:9",
"duration": 8,
"watermark": false,
"provider_specific": {"generate_audio": false}
}'Seedance-2.0 — 参考图生成视频
curl -X POST "https://api.senseaudio.cn/v1/video/create" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "Seedance-2.0",
"content": [
{"type": "text", "text": "保留人物服饰与场景氛围,生成一段自然运镜的短视频"},
{"type": "image", "url": "https://example.com/ref1.jpg", "role": "reference"},
{"type": "image", "url": "https://example.com/ref2.jpg", "role": "reference"}
],
"resolution": "720p",
"ratio": "3:4",
"duration": 10,
"watermark": false,
"provider_specific": {"generate_audio": true}
}'Seedance-2.0 — 参考图 + 音频生成视频
curl -X POST "https://api.senseaudio.cn/v1/video/create" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "Seedance-2.0",
"content": [
{"type": "text", "text": "根据参考图生成广告短片,整体节奏贴合背景音乐"},
{"type": "image", "url": "https://example.com/ref1.jpg", "role": "reference"},
{"type": "audio", "audio_url": "https://example.com/bgm.mp3"}
],
"resolution": "720p",
"ratio": "16:9",
"duration": 10,
"watermark": false,
"provider_specific": {"generate_audio": true}
}'Seedance-2.0 — 参考视频 + 参考图 + 音频生成视频
curl -X POST "https://api.senseaudio.cn/v1/video/create" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "Seedance-2.0",
"content": [
{
"type": "text",
"text": "全程使用视频1的第一视角构图,全程使用音频1作为背景音乐。第一人称视角果茶宣传广告,seedance牌「苹苹安安」苹果果茶限定款;首帧为图片1,你的手摘下一颗带晨露的阿克苏红苹果,轻脆的苹果碰撞声;2-4 秒:快速切镜,你的手将苹果块投入雪克杯,加入冰块与茶底,用力摇晃,冰块碰撞声与摇晃声卡点轻快鼓点,背景音:「鲜切现摇」;4-6 秒:第一人称成品特写,分层果茶倒入透明杯,你的手轻挤奶盖在顶部铺展,在杯身贴上粉红包标,镜头拉近看奶盖与果茶的分层纹理;6-8 秒:第一人称手持举杯,你将图片2中的果茶举到镜头前,杯身标签清晰可见,背景音「来一口鲜爽」,尾帧定格为图片2。背景声音统一为女生音色。"
},
{"type": "image", "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic1.jpg", "role": "reference"},
{"type": "image", "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic2.jpg", "role": "reference"},
{"type": "audio", "audio_url": "https://ark-project.tos-cn-beijing.volces.com/doc_audio/r2v_tea_audio1.mp3"},
{"type": "video", "video_url": "https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_tea_video1.mp4"}
],
"duration": 10,
"ratio": "16:9",
"resolution": "720p",
"watermark": false,
"provider_specific": {"generate_audio": true}
}'Seedance-2.0-Fast — 多模态生成视频
curl -X POST "https://api.senseaudio.cn/v1/video/create" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "Seedance-2.0-Fast",
"content": [
{"type": "text", "text": "根据参考图和参考视频生成节奏轻快的商品展示短片"},
{"type": "image", "url": "https://example.com/ref1.jpg", "role": "reference"},
{"type": "video", "video_url": "https://example.com/demo.mp4"}
],
"duration": 10,
"ratio": "16:9",
"resolution": "720p",
"watermark": true,
"provider_specific": {"generate_audio": true}
}'Seedance-Pro-1.5,仅支持 first_frame 和 last_frameSeedance-Pro-1.5,当只传一张图片时,未显式传 role 会按 first_frame 处理Seedance-Pro-1.5,仅传 last_frame 不合法,必须同时传 first_frameSeedance-2.0 与 Seedance-2.0-Fast 支持两类 image role:first_frame / last_frame 或 referenceSeedance-2.0 与 Seedance-2.0-Fast 中,首尾帧模式与参考素材模式不能混用Seedance-Pro-1.5、Seedance-2.0、Seedance-2.0-Fast 支持Seedance-Pro-1.5 支持:{"generate_audio": true, "camera_fixed": false}Seedance-2.0 与 Seedance-2.0-Fast 支持:{"generate_audio": true}Seedance-2.0 与 Seedance-2.0-Fast 不支持 camera_fixed| 参数名 | 类型 | 描述 |
|---|---|---|
| task_id | string | 任务 ID,用于查询视频生成状态 |
{
"task_id": "task_1234567890"
}curl -X POST "https://api.senseaudio.cn/v1/video/create" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "Seedance-2.0",
"content": [
{"type": "text", "text": "根据参考图生成一段自然运镜的商品短片"},
{"type": "image", "url": "https://example.com/ref1.jpg", "role": "reference"}
],
"resolution": "720p",
"ratio": "16:9",
"duration": 10,
"watermark": false,
"provider_specific": {"generate_audio": true}
}'创建任务后,使用返回的 task_id 使用任务查询文档查询任务进度。
Seedance-2.0 与 Seedance-2.0-Fast 支持首尾帧模式和参考素材模式,两种模式不能混用