跳转到主要内容
POST
cURL
这是 Seedance 视频生成 API 的有声视频-首帧接口。基于单张首帧图片和文本提示词生成带同步音频的视频。支持全部 4 个模型。提交异步任务后返回 id,需通过查询接口获取结果。
使用方式:在 content 中包含 text(提示词)、image_url(首帧图片,role=first_frame)和可选的 audio_url(参考音频,role=reference_audio),设置 generate_audio: true。ratio 为 adaptive 自动保持和首帧图片一致。

授权

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[]
必填

输入内容列表。必须包含 image_url(首帧),可选 text 和 audio_url

输入内容项

resolution
enum<string>
默认值:720p

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

可用选项:
480p,
720p,
1080p
ratio
enum<string>

视频宽高比,默认且仅支持 adaptive(自动保持与首帧图片一致)

可用选项:
adaptive
duration
integer
默认值:-1

视频时长(秒)。范围 [4, 30] 或 -1(智能选择)

generate_audio
boolean
默认值:true

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

output_format
enum<string>
默认值:mp4

输出格式。仅 Seedance 2.5 支持

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

是否添加水印

return_last_frame
boolean
默认值:false

是否返回尾帧图像

draft
boolean
默认值:false

是否开启样片模式。仅 Seedance 2.5 支持

callback_url
string

回调地址

execution_expires_after
integer
默认值:172800

任务超时阈值(秒)。范围 [3600, 259200]

priority
integer
默认值:0

执行优先级。范围 [0, 9]

safety_identifier
string

终端用户标识,不超过 64 字符

tools
object[]

工具配置

service_tier
enum<string>
默认值:default

服务等级

可用选项:
default

响应

200 - application/json

任务提交成功

id
string
必填

任务 ID

最后修改于 2026年10月22日