Wan 3.0 Video

视频生成模型,支持文生视频、首帧/首尾帧生成和多媒体参考生成。完成后返回临时视频链接,平台不转存。

<details>
<summary>基本信息</summary>

字段内容
类型模型 API
模型名称Wan 3.0 Video
模型编码wan3.0-video
模型类型视频生成(video)
调用方式POST /api/v1/tasks
调用模式异步
最大参考图片数10
最大参考视频数5
最大参考音频数5

</details>

鉴权

所有调用必须在请求头携带平台分配的 API Key:

Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

请求路径

POST /api/v1/tasks

该模型为异步任务。提交后返回平台 task_id,通过 GET /api/v1/tasks/{task_id} 查询结果;也可传入 callback_url 接收平台终态回调。

业务参数

input.prompt 与 input.media 至少提供一项;提示词最多 20,000 个字符。

参数类型必填默认值可选值 / 范围示例说明
modelstring是—wan3.0-video—模型编码。
channelstring否—dashscope_compatible—指定渠道;不传时按当前租户可用路由选择。
input.promptstring条件必填—最多 20,000 字符一艘木船驶过晨雾湖面视频描述;可用“图1”“视频1”“音频1”引用参考素材。
input.mediaarray条件必填—见媒体参数表—参考素材数组。
parameters.resolutionstring否1080P480P / 720P / 1080P720P输出分辨率。
parameters.ratiostring否adaptiveadaptive / 16:9 / 4:3 / 1:1 / 3:4 / 9:1616:9输出画幅比例。
parameters.durationinteger是—-1 或整数秒数5输出时长。无参考视频时为 2 至 30;参考视频模式时按总时长限制校验。-1 表示智能时长。
parameters.audioboolean否truetrue / falsetrue是否包含音频。
parameters.seedinteger否—0 至 214748364712345随机种子。
parameters.watermarkboolean否falsetrue / falsefalse是否添加水印。
callback_urlstring否—HTTPS URLhttps://example.com/hook任务进入终态时的平台回调地址。

媒体参数

input.media 的每项均包含 type 和 url。媒体 URL 在任务执行期间必须可访问。

type最大数量说明
first_frame1首帧图像。
last_frame1尾帧图像。
reference_image10参考图像。
reference_video5参考视频;单段 1 至 15 秒,合计不超过 15 秒。
reference_audio5参考音频;单段 1 至 15 秒,合计不超过 15 秒。
file1参考文件,不能与 link 同时使用。
link1网页链接,不能与 file 同时使用。

首帧/尾帧模式不能与参考图片、参考视频、参考音频、文件或网页链接混用;file 与 link 不能同时使用。图片支持 HTTP/HTTPS、OSS 临时 URL 或 data:image/...;base64,...,格式为 JPEG、JPG、PNG(无透明通道)、BMP、WEBP。

请求示例

文生视频

{
  "model": "wan3.0-video",
  "input": {
    "prompt": "一艘木船驶过晨雾湖面,镜头缓慢推进,电影质感。"
  },
  "parameters": {
    "resolution": "720P",
    "ratio": "16:9",
    "duration": 5,
    "audio": true,
    "watermark": false
  }
}

多媒体参考生成

{
  "model": "wan3.0-video",
  "input": {
    "prompt": "让图1中的角色按照视频1的节奏自然行走,并使用音频1作为对白参考。",
    "media": [
      {"type": "reference_image", "url": "https://example.com/character.png"},
      {"type": "reference_video", "url": "https://example.com/motion.mp4"},
      {"type": "reference_audio", "url": "https://example.com/voice.mp3"}
    ]
  },
  "parameters": {
    "resolution": "480P",
    "ratio": "9:16",
    "duration": 5
  },
  "callback_url": "https://example.com/hook"
}

成功响应

{
  "code": 1,
  "msg": "success",
  "data": {
    "task_id": "task_xxxxxxxxxxxx",
    "status": "pending",
    "model": "wan3.0-video",
    "created_at": "2026-08-12T12:00:00Z"
  }
}

查询任务结果

GET /api/v1/tasks/{task_id}
{
  "code": 1,
  "msg": "success",
  "data": {
    "task_id": "task_xxxxxxxxxxxx",
    "status": "completed",
    "result": {
      "video_url": "https://example.com/result.mp4",
      "usage": {
        "output_video_duration": 5,
        "SR": 720,
        "ratio": "16:9"
      }
    },
    "completed_at": "2026-08-12T12:05:00Z"
  }
}

result.video_url 是临时视频下载链接,有效期约 24 小时。平台不转存,也不提供永久保存,请及时下载或保存。

失败响应

{
  "code": 0,
  "msg": "请求参数不合法",
  "data": null
}

错误说明

场景说明
参数校验失败缺少提示词和媒体、媒体类型或数量不支持、首尾帧与参考模式混用,或分辨率、比例、时长、种子不在支持范围内。
媒体访问失败参考素材 URL 不可访问或格式不符合要求。
任务失败查询结果 status=failed,msg 返回安全的失败说明。
权限或余额不足请检查 API Key 权限、当前模型上架状态和账户余额。

价格查询

调用前请通过 GET /api/v1/pricing?type=model&model=wan3.0-video 查询有效价格。实际扣费以任务创建时的价格快照为准。

同类文章