万相 3.0(wan3.0-video 与 wan3.0-video-prime,两个模型调用方式完全相同,仅需切换请求体里的 model 字段)视频生成采用异步任务模式:先提交任务拿到 task_id,再轮询查询接口获取成片。接口路径、请求体、响应结构与阿里百炼(DashScope)原生完全一致——你只需把 Base URL 从百炼域名换成 https://api.looprouter.com、把 API Key 换成 LoopRouter 的 sk- 令牌,已有的百炼官方示例、SDK 或自研代码即可直接运行,无需业务空间 ID(WorkspaceId)。
文生、图生、参考生视频共用同一个接口,仅靠 input.media 数组的组合区分模式。wan3.0-video 与 wan3.0-video-prime 的请求体、参数、响应结构完全一致,切换模型只改 model 字段。模型清单、定价与常见问题见 能力总览。
ratio 仅支持 adaptive / 16:9 / 4:3 / 1:1 / 3:4 / 9:16,两个模型均不支持 21:9,传入会返回参数错误。
接入前请注意以下差异点,可以避开绝大多数排障时间:
  1. Base URL 为 https://api.looprouter.com,完整路径是 /api/v1/services/aigc/video-generation/video-synthesis,不需要 {WorkspaceId} 子域。
  2. 鉴权用 LoopRouter 的 sk- 令牌(Authorization: Bearer sk-...),不是百炼 API Key。
  3. X-DashScope-Async 请求头可选,值为 enabled。
  4. resolution 支持 480P / 720P / 1080P(默认 1080P);传入其他档位返回错误且不扣费。
  5. duration 传 2–30 的明确整数;网关不支持智能时长 -1。有视频输入时「输入视频总时长 + 输出时长 ≤ 30 秒」。
  6. 成功状态是 SUCCEEDED(全大写);成片 output.video_url 为临时链接,请尽快转存。

代码示例

请求参数速查

POST /api/v1/services/aigc/video-generation/video-synthesis,请求头 Authorization: Bearer sk-...、Content-Type: application/json;X-DashScope-Async 可选,值为 enabled。
网关不支持智能时长 duration: -1(提交时真实时长未知,无法按秒预扣,会返回参数错误)。请传 2–30 秒的明确整数。

media 数组

input.media 的每个元素为一个媒体对象,含 type 与 url 两个字段: url 支持三种形式:公网 URL(HTTP/HTTPS)、OSS 临时 URL(oss://...)、Base64 编码(data:{MIME_type};base64,{data})。 图像要求:JPEG/JPG/PNG(不支持透明通道)/BMP/WEBP,单边 [240, 8000]px,长宽比 ≤8:1,小于 20MB。视频要求:mp4/mov,单段 [1, 15] 秒,单边 [240, 4096]px,单文件 ≤100MB。音频要求:wav/mp3,单段 [1, 15] 秒,≤15MB。
first_frame / last_frame 与 reference_image / reference_video / reference_audio / file / link 互斥,不能在同一请求中混用,否则返回 The two modes are mutually exclusive 错误。

生成模式

查询任务

GET /api/v1/tasks/{task_id} 任务状态机:PENDING → RUNNING → SUCCEEDED / FAILED / CANCELED;UNKNOWN 表示任务不存在或已过查询有效期。 成功响应示例(与百炼原生结构一致):
成片地址在 output.video_url 字段,为临时链接,请及时转存;下载时请求中不要携带 Authorization 头。
usage 为成功任务的用量统计:output_video_duration 是实际输出时长(结算依据,向上取整到整秒计费),SR 为输出分辨率,fps 固定 30。

错误响应

错误采用与百炼一致的结构 {code, message, request_id}:
任务执行阶段的失败会在查询响应的 output 中回填 code / message,并把 task_status 置为 FAILED:
429 与 5xx 建议采用指数退避重试(如 2s → 4s → 8s)。参数校验失败、鉴权失败与内容审核拒绝均不扣费;已预扣的失败任务会自动退款。

相关文档

能力总览与定价

模型清单、技术规格、计费规则

快速开始

三步跑通第一个视频

AI 集成指南

llms.txt 与推荐提示词