跳转到主要内容
POST
cURL
这是 Seedance 视频生成 API 的编辑视频接口。基于参考视频进行编辑,支持删除、替换、修改等操作。支持全部 4 个模型。提交异步任务后返回 id,需通过查询接口获取结果。
使用方式:在 content 中包含 text(编辑指令)和 video_url(role=reference_video,待编辑视频),设置 omni_reference_task_type: “edit”。ratio 必须为 adaptive,duration 必须为 -1。

授权

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(编辑指令)和至少一个 video_url(reference_video)

输入内容项

omni_reference_task_type
enum<string>
必填

任务类型,固定为 edit(视频编辑)

可用选项:
edit
ratio
enum<string>
必填

视频宽高比,必须为 adaptive(自动保持与待编辑视频一致)

可用选项:
adaptive
duration
enum<integer>
必填

视频时长,必须为 -1(模型自动保持与待编辑视频基本一致,误差约 0.4 秒)

可用选项:
-1
generate_audio
boolean
默认值:true

是否生成同步音频

output_format
enum<string>
默认值:mp4

输出格式。mov 推荐用于视频编辑场景(高色彩精度)

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

是否添加水印

return_last_frame
boolean
默认值:false

是否返回尾帧图像

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日