Skip to main content
POST
创建视频生成任务(seedance 兼容协议)
此接口与 Seedance 官方协议一致,请求体可直接复用官方文档中的参数结构。model 须为平台模型标识,路由后由网关改写为渠道模型名;callback_url 由网关覆盖注入带签名的默认回调地址。

功能特性

  • 内容元素列表 content 支持文本、图片、视频、音频与草稿任务五种类型
  • 支持首帧 / 尾帧 / 参考图(2.0 系列 1-9 张)/ 参考视频 / 参考音频输入
  • 支持同步音频生成 generate_audio(仅 Seedance 2.0 系列与 1.5 Pro)
  • 支持在线 / 离线推理 service_tier 与任务超时阈值 execution_expires_after
  • 支持草稿模式 draft(仅 1.5 Pro)、尾帧返回 return_last_frame、任务优先级 priority(仅 2.0)
  • 支持视频编辑(仅 2.5),可编辑原视频的画面或音频,在视频中添加、删除或修改物体,或重绘、修复部分画面
  • 支持视频延长(仅 2.5),可向前或向后扩展原视频

认证方式

在请求头中携带 Authorization 字段,格式为 Bearer YOUR_API_KEY

支持的视频模型

快速示例

创建成功后返回任务 ID:

下一步

请求头

Authorization
string
必填

API Key token (Bearer sk-xxx)

Content-Type
string

请求体

application/json
model
string
必填

平台模型标识(如 seedance-2.0),路由后由网关改写为渠道模型名

callback_url
string

结果回调地址(任务状态变更时上游 POST 通知;网关配置回调后覆盖注入带签名的默认地址)

return_last_frame
boolean

是否返回生成视频的尾帧图(PNG,与视频同分辨率且无水印),默认 false; 可用于以上一视频尾帧作为下一任务首帧,快速生成多段连续视频

service_tier
string

服务层级:default 在线推理(默认)/ flex 离线推理(价格为在线 50%); Seedance 2.0 系列仅支持在线推理,不支持配置该参数

execution_expires_after
integer

任务超时阈值(秒),自 created_at 起算,取值 [3600, 259200],默认 172800(48 小时); 超时后任务自动终止并标记为 expired

camera_fixed
boolean

是否固定镜头,默认 false;参考图场景与 Seedance 2.0 系列不支持

generate_audio
boolean

是否生成与画面同步的音频(人声/音效/背景音乐),默认 true; 仅 Seedance 2.0 系列与 1.5 Pro 支持

safety_identifier
string

终端用户唯一标识(用于平台安全审计,英文且长度不超过 64 字符, 建议传入用户名/用户ID/邮箱的哈希值,避免泄露隐私)

content
object[]

内容元素列表(文本提示词 / 图片 / 视频 / 音频 / 草稿任务ID)

resolution
string

生成视频分辨率:480p / 720p / 1080p / 4k; Seedance 2.0 系列与 1.5 Pro 默认 720p,1.0 Pro / Pro Fast 默认 1080p; 1080p 不支持 2.0 Fast / 2.0 Mini,4k 仅支持 Seedance 2.0

ratio
string

生成视频宽高比:16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 / adaptive(按输入智能选择)

duration
integer

生成视频时长(整数秒),与 frames 二选一且 frames 优先,默认 5; Seedance 1.0 Pro / Pro Fast:[2, 12];1.5 Pro:[4, 12] 或 -1(模型智能选择时长); Seedance 2.0 系列:[4, 15] 或 -1

frames
integer

生成视频帧数(与 duration 二选一且优先),用于生成小数千秒的时长; 仅 Seedance 1.0 Pro / Pro Fast 支持(2.0 系列与 1.5 Pro 不支持), 取值 [29, 289] 且满足 25 + 4n(帧率 24,帧数 = 秒数 × 24)

seed
integer<int64>

随机种子,取值 [-1, 2^32-1],默认 -1(随机);Seedance 2.0 系列不支持

watermark
boolean

生成视频是否带 "AI Generated" 水印,默认 false

draft
boolean

是否启用草稿模式(480p 预览视频,费用更低,用于快速验证),默认 false; 仅 Seedance 1.5 Pro 支持;草稿模式不支持尾帧返回与离线推理

priority
integer

任务执行优先级 0-9,值越大排队越靠前,默认 0; 仅 Seedance 2.0 支持,仅作用于同一 Endpoint 的排队顺序,离线推理(flex)不支持

响应

200 - application/json
id
string

任务ID