wan万相 3.0 视频接口

万相 3.0 全能视频生成接口。异步任务接口，提交后返回 task_id，凭 task_id 轮询获取生成结果。

支持模型：

wan3.0-video：标准版

wan3.0-video-prime：高速版（能力对齐标准版，生成速度更快）

一个模型即可覆盖 文生视频、图生视频（首帧/首尾帧）、参考生视频（参考图/参考视频/参考音频）、文件/网页生视频（解析文档或网页内容） 多种用法，用法由传入的素材决定，无需切换模型。

接口地址

提交任务

POST https://www.moyu.info/v1/video/generations

查询结果

GET https://www.moyu.info/v1/video/generations/{task_id}

请求示例

文生视频（Text-to-Video）

仅传 prompt，不带任何素材。

cURL

其他语言

图生视频（首帧）

通过 input_reference 传入一张首帧图片 URL，视频将以该图为第一帧。

首帧 / 首尾帧 / 参考生视频（media 数组）

更精细的素材控制通过 media 数组表达。数组每个元素是一个 { "type": ..., "url": ... } 对象，type 指定素材角色：

type	含义	数量上限
`first_frame`	首帧图像（严格作为视频第一帧）	1
`last_frame`	尾帧图像（严格作为视频最后一帧）	1
`reference_image`	参考图像	10
`reference_video`	参考视频	5（合计 ≤ 15 秒）
`reference_audio`	参考音频	5（合计 ≤ 15 秒）
`file`	文档文件 URL，解析文档内容生成视频	1
`link`	网页链接，解析网页内容生成视频	1

first_frame / last_frame 与 reference_image / reference_video / reference_audio 不能在同一次请求中混用，请二选一。
file 与 link 二选一、各限 1 个，且不与其它素材类型混用。文档与网页链接仅支持无需登录的公开页面（否则模型无法抓取内容）。

首尾帧示例

参考生视频示例

可在 prompt 中用「图1」「视频1」「音频1」等按 media 数组中同类素材的出现顺序引用（图、视频、音频分别计数）。

参考图（简写）

若只需传若干张参考图，也可用 images 数组代替 media：

文件 / 网页生视频（file / link）

解析一个公开可访问的文档或网页内容来生成视频。file（文档 URL）与 link（网页 URL）二选一，各限 1 个，不与其它素材类型混用。

网页生视频示例

文件生视频示例

注意：文档 / 网页链接仅支持无需登录的公开页面；file 与 link 每次请求各限 1 个，二者及与其它素材类型均不可混用。

{
  "id": "dc153518-99ab-4185-980a-e9baf7cf0ba2",
  "object": "video",
  "model": "wan3.0-video",
  "status": "queued",
  "progress": 0,
  "created_at": 1787558977
}

重要：本接口为异步接口，返回 task_id（即 id 字段）后需要使用该 ID 查询生成结果。

查询结果

使用返回的 task_id 查询视频生成进度和结果。

任务进行中

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "dc153518-99ab-4185-980a-e9baf7cf0ba2",
    "action": "textGenerate",
    "status": "IN_PROGRESS",
    "fail_reason": "",
    "submit_time": 1787558977,
    "start_time": 1787558980,
    "finish_time": 0,
    "progress": "30%"
  }
}

视频生成成功

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "dc153518-99ab-4185-980a-e9baf7cf0ba2",
    "action": "textGenerate",
    "status": "SUCCESS",
    "fail_reason": "",
    "result_url": "https://cdn.moyu.info/video/xxx.mp4?sign=...",
    "submit_time": 1787558977,
    "start_time": 1787558980,
    "finish_time": 1787559145,
    "progress": "100%"
  }
}

说明：任务成功时，视频地址在 data.result_url 字段（此时 fail_reason 为空）；任务失败时 result_url 为空、fail_reason 记录失败原因。视频地址有时效性，请及时下载转存。

任务失败

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "dc153518-99ab-4185-980a-e9baf7cf0ba2",
    "action": "textGenerate",
    "status": "FAILURE",
    "fail_reason": "错误原因描述",
    "progress": "100%"
  }
}

请求参数

提交任务参数

参数	类型	必填	默认值	说明
model	string	是	-	模型名称：`wan3.0-video` 或 `wan3.0-video-prime`
prompt	string	条件必填	-	视频描述文本。`prompt` 与素材（`media`/`images`/`input_reference`）至少提供其一
resolution	string	否	1080P	视频分辨率：`480P`、`720P`、`1080P`
ratio	string	否	adaptive	画面宽高比：`adaptive`（自适应）、`16:9`、`4:3`、`1:1`、`3:4`、`9:16`
duration	number	否	5	视频时长（秒），范围 2-30；传 `-1` 为智能时长（由模型自动决定）
seed	integer	否	-	随机数种子，范围 [0, 2147483647]，用于复现生成结果
watermark	boolean	否	false	是否在视频上添加水印

素材参数（三者按需选用）

参数	类型	说明
media	array	素材数组，每项为 `{ "type": "...", "url": "..." }`。`type` 取值见下方「media 素材类型」
images	string[]	参考图 URL 数组（简写方式，等价于多个 `reference_image`）
input_reference	string	单张首帧图片 URL（简写方式，等价于一个 `first_frame`）

media 素材类型（`type` 字段取值）

type	含义	数量上限
`first_frame`	首帧图像	1
`last_frame`	尾帧图像	1
`reference_image`	参考图像	10
`reference_video`	参考视频	5（合计 ≤ 15 秒）
`reference_audio`	参考音频	5（合计 ≤ 15 秒）
`file`	文档文件 URL（解析文档内容）	1
`link`	网页链接（解析网页内容）	1

first_frame / last_frame 与 reference_* 系列互斥，不可在同一请求中同时出现。
file 与 link 二选一、各限 1 个，且不与其它素材类型混用；仅支持无需登录的公开文档 / 网页。

素材优先级：同时提供时以 media 为准；未提供 media 时，images / input_reference 会被自动组装为对应的参考图 / 首帧素材。

输入图片限制：

格式：JPEG、JPG、PNG、BMP、WEBP

分辨率：单边 [240, 8000] 像素

宽高比：不超过 8:1

文件大小：不超过 20MB

响应字段说明

提交任务响应字段

字段	类型	说明
id	string	任务唯一标识符（task_id），用于查询结果
object	string	对象类型，固定为 `video`
model	string	使用的模型名称
status	string	任务状态：`queued`（排队中）
progress	integer	进度百分比
created_at	integer	创建时间戳

查询结果响应字段

字段	类型	说明
code	string	响应码，`success` 表示查询成功
message	string	响应消息
data.task_id	string	任务 ID
data.action	string	操作类型，如 `textGenerate`
data.status	string	任务状态：`IN_PROGRESS`（进行中）、`SUCCESS`（成功）、`FAILURE`（失败）
data.progress	string	进度百分比，如 `"30%"`、`"100%"`
data.submit_time	integer	提交时间戳
data.start_time	integer	开始时间戳
data.finish_time	integer	完成时间戳
data.result_url	string	成功时的视频下载地址（有时效性）；失败时为空
data.fail_reason	string	失败原因；成功时为空

提示词建议

使用详细、具体的描述，包含场景、光线、动作、情绪等元素

参考生视频时，可在 prompt 中用「图1」「视频1」「音频1」按素材顺序引用，模型会按引用关系组合素材特征

建议轮询查询间隔约 15 秒

接口地址#

提交任务#

查询结果#

请求示例#

文生视频（Text-to-Video）#

cURL#

其他语言#

图生视频（首帧）#

首帧 / 首尾帧 / 参考生视频（media 数组）#

首尾帧示例#

参考生视频示例#

参考图（简写）#

文件 / 网页生视频（file / link）#

网页生视频示例#

文件生视频示例#

查询结果#

任务进行中#

视频生成成功#

任务失败#

请求参数#

提交任务参数#

素材参数（三者按需选用）#

media 素材类型（type 字段取值）#

响应字段说明#

提交任务响应字段#

查询结果响应字段#

提示词建议#

接口地址

提交任务

查询结果

请求示例

文生视频（Text-to-Video）

cURL

其他语言

图生视频（首帧）

首帧 / 首尾帧 / 参考生视频（media 数组）

首尾帧示例

参考生视频示例

参考图（简写）

文件 / 网页生视频（file / link）

网页生视频示例

文件生视频示例

查询结果

任务进行中

视频生成成功

任务失败

请求参数

提交任务参数

素材参数（三者按需选用）

media 素材类型（`type` 字段取值）

响应字段说明

提交任务响应字段

查询结果响应字段

提示词建议