MU 通义万相 3.0

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

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

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

接口地址

提交任务

POST https://tokener.jeekmind.com/v1/video/generations

查询结果

GET https://tokener.jeekmind.com/v1/video/generations/{task_id}

请求示例

文生视频（Text-to-Video）

仅传 prompt，不带任何素材。

cURL

curl -X POST "https://tokener.jeekmind.com/v1/video/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "prompt": "一只小猫在月光下的屋顶上奔跑，城市的霓虹灯在远处闪烁，电影级画质，流畅运镜。",
    "resolution": "1080P",
    "ratio": "adaptive",
    "duration": 5
  }'

图生视频（首帧）

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

curl -X POST "https://tokener.jeekmind.com/v1/video/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "prompt": "镜头缓缓推进，画面从冷色调渐变为暖色调",
    "input_reference": "https://example.com/first-frame.png",
    "resolution": "1080P",
    "duration": 5
  }'

首帧 / 首尾帧 / 参考生视频（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 个，且不与其它素材类型混用。文档与网页链接仅支持无需登录的公开页面（否则模型无法抓取内容）。

首尾帧示例

curl -X POST "https://tokener.jeekmind.com/v1/video/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "prompt": "一个女孩从微笑逐渐变为大笑，镜头缓缓推进",
    "media": [
      { "type": "first_frame", "url": "https://example.com/start.png" },
      { "type": "last_frame",  "url": "https://example.com/end.png" }
    ],
    "resolution": "1080P",
    "duration": 5
  }'

参考生视频示例

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

curl -X POST "https://tokener.jeekmind.com/v1/video/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "prompt": "图1中的女性手持图2的折扇，随图3的音乐节奏轻盈起舞",
    "media": [
      { "type": "reference_image", "url": "https://example.com/girl.jpg" },
      { "type": "reference_image", "url": "https://example.com/fan.jpg" },
      { "type": "reference_audio", "url": "https://example.com/music.mp3" }
    ],
    "resolution": "1080P",
    "ratio": "adaptive",
    "duration": 5
  }'

参考图（简写）

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

curl -X POST "https://tokener.jeekmind.com/v1/video/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "prompt": "身着红色旗袍的女性 图1，轻抬玉手 图2",
    "images": [
      "https://example.com/girl.jpg",
      "https://example.com/hand.jpg"
    ],
    "resolution": "1080P",
    "duration": 5
  }'

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

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

网页生视频示例

curl -X POST "https://tokener.jeekmind.com/v1/video/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "prompt": "根据网页内容生成一段介绍视频，节奏明快、画面丰富",
    "media": [
      { "type": "link", "url": "https://example.com/public-article" }
    ],
    "resolution": "1080P",
    "ratio": "adaptive",
    "duration": 5
  }'

文件生视频示例

curl -X POST "https://tokener.jeekmind.com/v1/video/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "prompt": "根据文档内容生成一段讲解视频",
    "media": [
      { "type": "file", "url": "https://example.com/public-doc.pdf" }
    ],
    "resolution": "1080P",
    "duration": 5
  }'

注意：文档 / 网页链接仅支持无需登录的公开页面；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 查询视频生成进度和结果。

curl -X GET "https://tokener.jeekmind.com/v1/video/generations/{task_id}" \
  -H "Authorization: Bearer YOUR_API_KEY"

请求参数

提交任务参数

参数	类型	必填	默认值	说明
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` 字段取值）

响应字段说明

提交任务响应字段

查询结果响应字段

提示词建议