跳转到主要内容
POST
cURL
这是 Seedance 视频生成 API 的全模态参考接口。基于参考图片和视频,融合多模态内容生成新视频。支持全部 4 个模型。提交异步任务后返回 id,需通过查询接口获取结果。
使用方式:在 content 中包含 text(提示词)、image_url(role=reference_image,参考图片)、video_url(role=reference_video,参考视频)和可选的 audio_url(role=reference_audio,参考音频),设置 omni_reference_task_type: "reference"。

授权

TT-API-KEY
string
header
必填

请前往 TTAPI 控制台 获取 API 密钥。

请求体

application/json
model
enum<string>
必填

模型 ID

可用选项:
doubao-seedance-2-5-260628,
doubao-seedance-2-0-260128,
doubao-seedance-2-0-fast-260128,
doubao-seedance-2-0-mini-260615
content
object[]
必填

输入内容列表。支持 text + image_url(reference_image) + video_url(reference_video) + audio_url(reference_audio) 组合

输入内容项,支持 text、image_url、video_url、audio_url、draft_task 类型

omni_reference_task_type
enum<string>
必填

任务类型,固定为 reference(参考生视频)。可选值:auto=自动判定、reference=参考生视频、edit=视频编辑、extend=视频延长

可用选项:
reference
resolution
enum<string>
默认值:720p

视频分辨率。Seedance 2.5 可选:480p、720p、1080p,默认 720p

可用选项:
480p,
720p,
1080p
ratio
enum<string>
默认值:adaptive

视频宽高比。默认 adaptive(自动),也可指定具体宽高比

可用选项:
adaptive,
16:9,
4:3,
1:1,
3:4,
9:16,
21:9
duration
integer
默认值:-1

视频时长(秒)。范围 [4, 30] 或 -1(智能选择)。duration 和 frames 二选一,frames 优先级更高

generate_audio
boolean
默认值:true

是否生成同步音频。true=包含人声/音效/背景音乐,false=无声视频。仅 Seedance 2.5/2.0 支持

output_format
enum<string>
默认值:mp4

输出格式。mp4=通用格式,mov=高色彩精度(H.264+yuv444p+PCM,适用于专业后期)。仅 Seedance 2.5 支持

可用选项:
mp4,
mov
watermark
boolean
默认值:false

是否添加水印。true=右下角显示「AI 生成」

return_last_frame
boolean
默认值:false

是否返回尾帧图像。true=返回 jpeg 格式尾帧,可用于连续视频生成

draft
boolean
默认值:false

是否开启样片模式。true=生成 480p 预览视频。仅 Seedance 2.5 支持

callback_url
string

回调地址。任务状态变化时推送 POST 请求,内容与查询 API 返回体一致

execution_expires_after
integer
默认值:172800

任务超时阈值(秒)。范围 [3600, 259200](1~72 小时),默认 172800(48 小时)

priority
integer
默认值:0

执行优先级。范围 [0, 9],数值越大优先级越高,默认 0(FIFO)。仅 Seedance 2.5/2.0 支持

safety_identifier
string

终端用户唯一标识符,不超过 64 字符。建议传入哈希处理后的字符串

tools
object[]

工具配置。仅 Seedance 2.5/2.0 支持

service_tier
enum<string>
默认值:default

服务等级。default=在线推理,flex=离线推理(价格 50%,Seedance 2.5/2.0 暂不支持)

可用选项:
default
seed
integer
默认值:-1

随机种子。范围 [-1, 2147483647],-1=随机

camera_fixed
boolean
默认值:false

是否固定摄像头。true=固定摄像头(参考图场景不支持)

frames
integer

视频帧数。范围 [29, 289],需满足 25+4n 格式。与 duration 二选一,frames 优先级更高

响应

200 - application/json

任务提交成功

id
string
必填

任务 ID

最后修改于 2026年10月22日