Wan 3.0 视频生成接口文档

本文档说明 token-gateway 中 Wan 3.0 视频生成接口的调用方式。接口兼容阿里云百炼 Wan 3.0 异步任务协议，统一支持文生视频、首帧/首尾帧生视频、参考生视频、视频编辑及视频延长等场景。

• 视频生成
• 查询任务结果

1. 接口概览

2. 鉴权

所有接口都需要网关 Token 鉴权。

复制成功⧉
Authorization: Bearer {API_KEY}
Content-Type: application/json

3. 创建视频任务

请求：POST https://router.253.com/wan3/api/v1/services/aigc/video-generation/video-synthesis

3.1 支持的模型

3.2 请求体

3.3 parameters生成参数

3.4 媒体素材类型

**图像限制：**JPEG、JPG、PNG（不支持透明通道）、BMP、WEBP；单边 240 至 8000 像素；长宽比不超过 8:1；单文件不超过 20 MB。

**视频限制：**MP4、MOV；帧率不低于 16 fps；单边 240 至 4096 像素；长宽比不超过 8:1；单文件不超过 100 MB。

**音频限制：**WAV、MP3；单文件不超过 15 MB。

3.5 素材组合规则

• 文生视频只传 prompt，不传 media。

• first_frame/last_frame 与 reference_image/reference_video/reference_audio/file/link 互斥。

• file 与 link 二选一，但都可以与参考图片、参考视频、参考音频组合。

• reference_image、reference_video、reference_audio 可以自由组合。

• 在提示词中可使用“图 1”“视频 1”“音频 1”等表述引用 media 中同类型素材，图片、视频、音频分别独立计数。

3.6 示例：文生视频

复制成功⧉
curl -X POST "https://router.253.com/wan3/api/v1/services/aigc/video-generation/video-synthesis" \
  -H "Authorization: Bearer {TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "input": {
      "prompt": "一只金毛犬在阳光明媚的海滩上奔跑，海浪在背景中翻涌，电影感光影"
    },
    "parameters": {
      "resolution": "1080P",
      "ratio": "16:9",
      "duration": 5,
      "audio": true,
      "prompt_extend": true,
      "watermark": false
    }
  }'

3.7 示例：首帧/首尾帧生视频

复制成功⧉
{
  "model": "wan3.0-video",
  "input": {
    "prompt": "一个年轻女孩从微笑逐渐变为大笑，镜头缓缓推进，背景光线从冷色调渐变为暖色调。",
    "media": [
      {
        "type": "first_frame",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/wpimhv/rap.png"
      },
      {
        "type": "last_frame",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260408/sjuytr/wan-r2v-object-girl.jpg"
      }
    ]
  },
  "parameters": {
    "resolution": "1080P",
    "ratio": "adaptive",
    "duration": 5,
    "audio": true
  }
}

只使用首帧时，删除 last_frame 项即可。首帧/首尾帧模式不能同时传入参考图片、参考视频、参考音频、文件或网页素材。

3.8 示例：多模态参考生视频

复制成功⧉
{
  "model": "wan3.0-video",
  "input": {
    "prompt": "视频1抱着图3，在图4的椅子上弹奏一支舒缓的乡村民谣，并说道：\"今天的阳光真好。\"图1手中拿着图2，路过视频1，把手中的图2放到视频1旁边的桌子上，并说道：\"真好听，能不能再唱一遍\"。",
    "media": [
      {
        "type": "reference_image",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260408/sjuytr/wan-r2v-object-girl.jpg"
      },
      {
        "type": "reference_video",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/qigswt/wan-r2v-role2.mp4"
      },
      {
        "type": "reference_image",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/rtjeqf/wan-r2v-object3.png"
      },
      {
        "type": "reference_image",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/qpzxps/wan-r2v-object4.png"
      },
      {
        "type": "reference_image",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/wfjikw/wan-r2v-backgroud5.png"
      }
    ]
  },
  "parameters": {
    "resolution": "480P",
    "ratio": "adaptive",
    "duration": 5,
    "prompt_extend": true
  }
}

3.9 创建成功响应

复制成功⧉
{
  "output": {
    "task_status": "PENDING",
    "task_id": "task_xxxxxxxxxxxxxxxxxxxxxxxx"
  },
  "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

响应中的 task_id 是网关公开任务 ID，不是上游真实任务 ID。后续查询必须原样使用该 ID。

4. 查询任务

请求：GET https://router.253.com/wan3/api/v1/tasks/{task_id}

复制成功⧉
curl -X GET "https://router.253.com/wan3/api/v1/tasks/{task_id}" \
  -H "Authorization: Bearer {TOKEN}"

4.1 任务状态

4.2 成功响应

复制成功⧉
{
  "request_id": "78c9b768-0285-996c-b682-xxxxxx",
  "output": {
    "task_id": "task_xxxxxxxxxxxxxxxxxxxxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2026-10-28 10:01:35.452",
    "scheduled_time": "2026-10-28 10:01:35.507",
    "end_time": "2026-10-28 10:03:33.838",
    "orig_prompt": "一只金毛犬在阳光明媚的海滩上奔跑",
    "video_url": "https://example.com/generated-video.mp4"
  },
  "usage": {
    "video_count": 1,
    "duration": 5,
    "input_video_duration": 0,
    "output_video_duration": 5,
    "fps": 30,
    "SR": 1080,
    "ratio": "16:9"
  }
}

上游生成结果 URL 通常只保留 24 小时。客户端应在任务成功后立即下载并转存至长期存储。

4.3 失败响应

复制成功⧉
{
  "request_id": "e5e57877-c0fc-47ed-8fad-xxxxxx",
  "output": {
    "task_id": "task_xxxxxxxxxxxxxxxxxxxxxxxx",
    "task_status": "FAILED",
    "code": "InvalidParameter",
    "message": "The two modes are mutually exclusive. Do not pass reference_xx and first_frame/last_frame at the same time."
  }
}

5. 错误处理

创建任务或查询任务发生 HTTP 错误时，网关返回与阿里官方格式兼容的错误对象：

复制成功⧉
{
  "code": "invalid_request",
  "message": "parameters.duration must be -1 or between 2 and 30",
  "request_id": ""
}