Seedance V3（原生）视频生成

原生 Seedance V3（doubao-seedance-*）是火山原生协议接入的视频生成模型：报文为火山方舟原厂格式，平台负责鉴权、选渠道与任务托管。配套 /v3/assets 素材库。

与 Seedance_sup 的区别

• 本页：原生 Seedance V3（doubao-seedance-*），原厂协议 /v3/video/tasks；
• Seedance_sup（seedance-2-0 系列）：统一接口 /v1/videos（OpenAI Video 风格）——见 Seedance_sup 使用说明。
• 两套模型名、接口与素材库均不同，请勿混用。

端点

• 创建任务（原厂报文）：POST $URL/v3/video/tasks
• 查询任务：GET $URL/v3/video/tasks/{task_id}
• 取消任务：DELETE $URL/v3/video/tasks/{task_id}

支持模型

模型名称	定位	支持分辨率
doubao-seedance-2.5	最新旗舰版，质量与一致性最强	480p / 720p
doubao-seedance-2.0	标准版，质量最高	480p / 720p / 1080p / 4k
doubao-seedance-2.0-fast	快速版，速度与质量平衡	480p / 720p
doubao-seedance-2.0-mini	轻量版，性价比最高	480p / 720p
doubao-seedance-1.5-pro	1.5 专业版	480p / 720p / 1080p

主要参数

字段	类型	必填	说明
model	string	是	上表中的模型名
content	array	是	多模态内容数组：`{type:'text'
resolution	string	否	480p/720p/1080p/4k（各模型支持范围见上表），默认 720p
ratio	string	否	16:9/9:16/1:1/4:3/3:4/21:9，默认 16:9
duration	integer	否	5/10（秒），默认 5
generate_audio	boolean	否	是否生成音频，默认 true
service_tier	string	否	default/flex/batch（default=实时，flex/batch=降级档位）
callback_url	string	否	任务完成回调地址

请求示例

文生视频

curl $URL/v3/video/tasks \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2.0",
    "content": [
      { "type": "text", "text": "一只戴着墨镜的猫走在霓虹灯街道上，镜头缓慢推进" }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "generate_audio": true
  }'

图生视频

curl $URL/v3/video/tasks \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2.0",
    "content": [
      { "type": "text", "text": "让画面中的人物转身走向镜头" },
      { "type": "image_url", "image_url": { "url": "https://example.com/ref.png" } }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "generate_audio": true
  }'

响应字段

创建任务返回任务信息，查询任务返回最新状态：

字段	类型	说明
id	string	任务 ID（原厂 task_id）
model	string	实际使用的模型
status	string	任务状态（queued/in_progress/succeeded/failed 等，以原厂报文为准）
content	array	与原厂报文一致的任务详情
created_at	integer	创建时间戳（秒）

响应示例

{
  "id": "task_xxxxxxxx",
  "model": "doubao-seedance-2.0",
  "status": "in_progress",
  "created_at": 1785000000
}

完成后（结构以原厂报文为准）：

{
  "id": "task_xxxxxxxx",
  "model": "doubao-seedance-2.0",
  "status": "succeeded",
  "content": { "video_url": "https://.../seedance-v3-xxxx.mp4" }
}

查询 / 取消任务

操作	方法与路径	说明
查询任务	GET $URL/v3/video/tasks/{task_id}	返回原厂报文
取消任务	DELETE $URL/v3/video/tasks/{task_id}	取消排队中任务；删除已终态记录

# 查询
curl $URL/v3/video/tasks/{task_id} \
  -H "Authorization: Bearer $YOUR_API_KEY"

# 取消
curl -X DELETE $URL/v3/video/tasks/{task_id} \
  -H "Authorization: Bearer $YOUR_API_KEY"

素材库

原生 Seedance V3 配套素材库 /v3/asset-groups、/v3/assets（分组 + 素材，按客户强制隔离）。素材 URL 放入 content[] 的 image_url / video_url 引用，见 素材库 V3。

常见问题

Q: 返回 400 / 参数错误？

检查 content[] 结构是否为火山原厂格式（text/image_url/video_url 三种 type）；video_url 引用素材需先上传到素材库并处理完成。

Q: 任务超时会怎样？

超过 20 分钟未完成自动置为失败，不会无限等待。