万相 3.0 是阿里通义万相系列的全能参考视频生成模型（All-in-One），提供 wan3.0-video 与 wan3.0-video-prime 两个模型，调用方式完全相同，用同一个接口统一支持文生视频、图生视频（首帧 / 首尾帧）与参考生视频（参考图 / 参考视频 / 参考音频 / 文件 / 网页链接）。单次最长可生成 30 秒视频，输出帧率 30fps，并可选择是否携带音轨。LoopRouter 以与阿里百炼（DashScope）完全一致的原生接口对外提供该能力：接口路径、请求体、响应结构都与百炼官方相同，你只需把 Base URL 从百炼域名换成网关地址、把 API Key 换成 LoopRouter 令牌，其余代码一行不改。
换 Base URL 即可使用：把原本指向 https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com 的请求改为 https://api.looprouter.com 即可——网关不需要 WorkspaceId 子域，也不需要百炼 API Key，统一用 LoopRouter 的 sk- 令牌鉴权。已有的百炼官方示例、SDK 或自研代码无需改动请求结构。

​
快速入口

视频生成 API

完整参数、四种生成模式、media 数组、响应结构与错误码

快速开始

三步跑通第一个视频任务

计费与分组

分辨率档位单价与分组倍率说明

AI 集成指南

把文档直接交给 ChatGPT / Claude 接入

​
核心特性

一个接口四种模式

文生 / 首帧图生 / 首尾帧图生 / 参考生视频，共用同一端点，仅靠 input.media 组合区分

全能参考生视频

参考图 ≤10、参考视频 ≤5、参考音频 ≤5，还可传文件或网页链接，prompt 中用「图1」「视频1」指代素材

更长单段时长

时长范围 2–30 秒，一次生成覆盖更完整的镜头叙事

音画同步

audio 默认开启，输出视频自带声音；开关声音价格相同

​
模型清单

两个模型调用方式完全相同，只需切换请求体里的 model 字段值即可；实际可用模型与定价以控制台「模型广场」为准，无需关心上游版本后缀或接入点 ID。

​
技术规格

first_frame / last_frame（首帧、尾帧）与 reference_image / reference_video / reference_audio / file / link（参考类）互斥，不能在同一请求中混用。

​
端点一览

Base URL：https://api.looprouter.com
所有接口统一使用 Authorization: Bearer sk-... 请求头，API Key 在 控制台 → 令牌 创建。X-DashScope-Async 头可选，值为 enabled。
与百炼官方的两点取值差异，接入前请留意：
  1. 网关地址不带 WorkspaceId：直接用 https://api.looprouter.com，不需要业务空间 ID 子域。
  2. 不支持智能时长 duration: -1：请传 2–30 秒的明确整数。提交时长未知会导致按秒计费无法预扣，故网关直接返回参数错误。

​
模型定价

计费采用提交预扣、完成结算的两段式流程，与 Seedance 2.5 / 可灵 3.0 同一「按秒 × 按分辨率档」机制：
1

提交预扣

任务创建成功后，按请求的分辨率档位与时长预估并预扣一笔额度，日志中心产生一条预扣记录。分辨率越高、时长越长，预扣越多。
2

完成结算

任务成功后按实际输出时长（向上取整到整秒）结算，多退少补；任务失败则全额退回预扣。
按秒计费，单价按分辨率档位区分：分辨率越高单价越高，1080P（默认）> 720P > 480P。具体单价以控制台「模型广场」展示为准。
计费规则：时长向上取整到整秒，最短按 1 秒、最长按 30 秒计。开关音频（audio）不影响价格。不扣费场景：参数校验失败、鉴权失败、内容审核拒绝均不产生费用；已预扣的失败任务会自动退款。
实际扣费还会应用 API Key 所在分组的计费倍率（具体折扣以商务对接约定为准），分组同时决定可用的分辨率档位。

​
限流与重试

  • 平台按渠道维度做 RPM 智能调度：并发高峰时任务会短暂排队而不是直接失败。
  • 收到 429（Throttling，当前分组上游负载已饱和）或 5xx 时，建议指数退避重试（2s → 4s → 8s）。
  • 轮询查询接口建议间隔 15 秒；时长越长生成耗时越久，长视频请适当延长轮询周期与超时时间。

​
常见问题

把请求域名从 https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com 换成 https://api.looprouter.com，把 Authorization 里的百炼 API Key 换成 LoopRouter 的 sk- 令牌即可。路径 /api/v1/services/aigc/video-generation/video-synthesis 与 /api/v1/tasks/{task_id}、请求体与响应结构都保持不变，无需业务空间 ID。
这是异步任务接口：创建仅入队并返回 output.task_id，需轮询 GET /api/v1/tasks/{task_id} 直到 task_status 变为 SUCCEEDED，再从 output.video_url 下载成片。
是 SUCCEEDED（全大写）。终态请匹配 SUCCEEDED / FAILED / CANCELED；UNKNOWN 表示任务不存在或已过查询有效期。
万相 3.0 支持 480P / 720P / 1080P 三档，默认 1080P。官方未提供更高档位，传入其他值会返回参数错误且不扣费。
网关不支持 -1。因为提交时真实时长未知，无法按秒预扣，会导致少收费。请传 2–30 秒的明确整数；有视频输入时确保「输入 + 输出 ≤ 30 秒」。
不能。first_frame / last_frame 与 reference_image / reference_video / reference_audio / file / link 互斥，混用会返回 The two modes are mutually exclusive 错误。
output.video_url 是临时链接，任务成功后请尽快下载并转存到自己的存储；过期后可重新调用查询接口获取新链接，但任务本身也有保留期限。

​
相关文档

视频生成 API

参数、media 数组与响应详解

快速开始

三步跑通第一个视频

AI 集成指南

llms.txt 与推荐提示词