Skip to main content
通义万相
万相使用统一的 MixRoute 视频端点。model 保留在顶层,厂商的 input 与 parameters 对象完整放入 metadata。不同版本使用不同输入协议,请按完整模型 ID 选择下方参数。 POST https://api.mixroute.ai/v1/video/generations

支持模型

模型可用性以账户的 模型列表 为准,不将未返回的厂商型号或日期快照视为已开通。

请求包装

使用 MixRoute Key 与 Authorization: Bearer 认证,无需阿里 Key、业务空间 ID、地域端点或 X-DashScope-Async 请求头。不要将 input/parameters 放到顶层,也不要将其内容平铺到 metadata 下。
提示词使用 metadata.input.prompt。兼容写法的优先级依次为 metadata.input.prompt、metadata.prompt、顶层 prompt,前者存在时优先。提示词与有效媒体至少提供其一,并继续满足所选模型自身的必填规则。 原生字段保持名称透传;上游新增字段可放在原有 input/parameters 位置,由上游校验型号与场景约束。这不代表每个字段都适用于所有型号。

Wan 3.0

媒体类型

  • 首帧/首尾帧组与 reference_*、file、link 互斥。与万相 2.7 I2V 不同,3.0 首尾帧模式不能搭配驱动音频。
  • 参考图片、视频和音频可相互组合;file 与 link 二选一,但可与 reference_* 组合,仍须满足各类型数量上限和总计 20 个媒体素材的上限。
  • 素材按类型分别计数,在提示词中用图1、视频1、音频1,或 Image 1、Video 1、Audio 1 指代。
  • 编辑/延长须传 reference_video 并在提示词中说明意图。延长使用 ratio=adaptive;编辑可用 adaptive 与 duration=-1 保留源构图并自动选择时长。输入视频总时长与输出时长之和仍须不超过 30 秒。
万相 3.0 不使用 size、negative_prompt、template、img_url、first_frame_url、last_frame_url、audio_url。网关会清理旧字段,并可将 audio_url 转为 reference_audio 媒体项;新请求直接使用 input.media。

Wan 2.7

输入模式

I2V 使用 first_clip 续写时,duration 控制包含源片段的最终总时长,不只是新增秒数。R2V 使用图1/视频1或 Image 1 / Video 1,图片与视频分别计数。2.7 不再沿用 2.6 T2V/R2V 的 size 或 shot_type;I2V 输出比例跟随源素材,不传 ratio。

Wan 2.6

T2V / R2V 尺寸

2.6 R2V 按 reference_urls 顺序用 character1、character2 等引用主体,不使用 2.7 的图/视频分别编号。参考素材使用公网 HTTP/HTTPS 或可访问的 OSS URL。此处列出的 2.6 标准型号不套用其他 Flash 型号的 audio=false 开关;旧版特效模板也不是这八个型号的通用能力。

媒体限制

优先使用公网 URL。OSS 临时资源和厂商资产 ID 与上游账户、地域有关,须可被当前渠道访问。读取第三方 CDN 结果地址时,不要附带 MixRoute Key。

请求示例

设置 MIXROUTE_API_KEY,并将 example.com 媒体地址替换为可访问的源素材。每次 POST 会创建独立任务,提交超时后不要自动重复提交。

Wan 3.0 Video

Wan 2.7 T2V

Wan 2.7 I2V

Wan 2.7 R2V

Wan 2.7 VideoEdit

Wan 2.6 T2V

Wan 2.6 I2V

Wan 2.6 R2V

首尾帧

文件输入,不传提示词

响应与轮询

提交返回 MixRoute task_id(以及 id 别名),不是上游任务 ID。
GET https://api.mixroute.ai/v1/video/generations/{task_id}
只在 SUCCESS 后读取 result_url。失败时该字段可能填入失败原因,不一定是 URL。外层 code=“success” 仅代表查询成功,不代表视频生成成功。
上游完整响应保留在 data.data,可读取其中的 usage 与 request_id。UNKNOWN 表示上游任务不存在或已过期,不应一概当作生成失败。建议每 15 秒查询一次,限流或临时错误时退避。上游任务查询和结果链接保留期有限,通常为 24 小时,应及时保存产物。

Python 完整流程

最终费用以控制台账单为准。提交可能预扣额度,预扣与任务完成后的结算可能不同;不要将输入时长、负数或零时长理解为零费用任务。