Skip to main content
POST
Wan 2.7 视频编辑

简介

通过 Gravitex 网关调用阿里云百炼 wan2.7-videoedit 模型,对已有视频做指令式编辑(替换人物、修改服装、调整场景风格等)。接口为异步:先提交任务,再轮询结果。 其中 {task_id} 为创建任务返回的 id
万相 2.7 视频生成(T2V / I2V / R2V)共用统一视频入口,但模型与 media 参数语义不同,请勿混用。

认证

string
必填
Bearer Token,如 Bearer sk-xxxxxxxx
string
必填
固定为 application/json
string
请求跟踪 ID,建议每次请求生成唯一值

请求参数

string
必填
固定为 wan2.7-videoedit
string
必填
视频编辑指令
integer
输出视频时长(秒),示例为 4
string
必填
传给阿里云的原始提示词,建议与顶层 prompt 保持一致
array
必填
输入媒体数组,至少包含一个视频
string
必填
原视频使用 video;参考图使用 reference_image(最多 4 张)
string
必填
公网可访问的 HTTP/HTTPS URL 或符合上游要求的临时 URL
string
720P1080P
boolean
是否启用提示词智能改写
boolean
是否添加水印

请求示例

最小请求(仅输入视频):
添加参考图: 可在同一个 media 数组中追加参考图;提示词里可用「图 1」指代。最多支持 4 张参考图。

创建任务响应

创建成功后返回标准化视频任务对象(无 code/message/data 外层):
请保存返回的 id,用于后续查询。

查询任务

查询响应带有 code/message/data 外层:

状态处理

客户端应以 data.status 作为平台标准状态: 上游状态位于 data.metadata.output.task_status(如 PENDINGSUCCEEDED),仅用于排查,不建议作为主状态判断依据。 建议轮询间隔 5~15 秒,不要高频轮询。

输出视频 URL

成功后优先读取 data.video_url,也可读取 data.url(当前适配器中通常相同)。 输出 URL 为带签名的临时地址,不应永久保存为业务资源地址;需长期保存时,请在有效期内下载或转存到自有 OSS。

时长和计费

实测中请求 duration: 4 时,上游 usage 可能如下: 因此 data.seconds = 8 不代表输出生成了 8 秒,而是输入与输出合计计费时长。 阿里云官方计费:按「输入视频时长 + 输出视频时长」计费;输入图像不计费。详见 官方计费说明

常见错误排查

Python 最小示例