万相 3.0 标准版 可根据文本和参考素材生成视频。
概览
可从文字生成视频,也可用首尾帧控制画面,或用视频与音频作为参考。异步任务完成后,上游返回 MP4 文件。
- 版本
- wan3.0-video
- 输入 / 输出
- 文本, 图像, 视频, 音频 / 视频
- 接口路径
- /v1/videos, /v1/videos/{video_id}, /v1/videos/{video_id}/content
接口协议与接入
Authorization: Bearer ITERACOMPUTE_API_KEY
POST /v1/videosGET /v1/videos/{video_id}GET /v1/videos/{video_id}/content
提交一次后按返回 ID 查询,完成后下载。计费时长为输入参考视频秒数与输出秒数之和。
LLMs.txt
LLMs.txt
# wan/wan3.0-video
Revision: fc7ebd1cf1f3550ee90a98afb4228ae12aa7887001ce81b456054f377375744b
Authorization: Bearer ITERACOMPUTE_API_KEY
POST https://api.iteracompute.com/v1/videos
GET https://api.iteracompute.com/v1/videos/{video_id}
GET https://api.iteracompute.com/v1/videos/{video_id}/content
- prompt · string · 视频描述,未提供参考素材时必填。
- media · array · 按顺序提供 type 和 url。首尾帧单独使用。
- resolution · enum · 输出分辨率。 · ["480P","720P","1080P"] · default="1080P"
- ratio · enum · 输出宽高比。 · ["adaptive","21:9","16:9","4:3","1:1","3:4","9:16"] · default="adaptive"
- duration · integer · 2–30 秒,或设为 −1 自动决定时长。参考视频与输出总时长最多 30 秒。 · [-1, 30] · default=5
- seed · integer · 随机种子,−1 表示随机。 · [-1, 2147483647] · default=-1
- audio · boolean · 生成音轨。 · default=true
- watermark · boolean · 添加上游水印。 · default=false
- prompt_extend · boolean · 提示词改写,使用文件或网页参考时必须启用。 · default=true
安装 requests,设置 ITERACOMPUTE_API_KEY。提交一次后保留任务 ID。脚本用同一把 Key 查询终态并下载视频。超时后可用打印的 ID 继续查询。
import json
import time
import os
from pathlib import Path
import requests
base = "https://api.iteracompute.com/v1"
headers = {"Authorization": "Bearer " + os.environ["ITERACOMPUTE_API_KEY"]}
payload = json.loads("{\n \"model\": \"wan/wan3.0-video\",\n \"prompt\": \"A blue paper boat on a calm lake\",\n \"resolution\": \"480P\",\n \"duration\": 2,\n \"audio\": false\n}")
r = requests.post(base + "/videos", headers=headers, json=payload, timeout=60)
r.raise_for_status()
job = r.json()["id"]
print("Video ID:", job, flush=True)
path = base + "/videos/" + job
deadline = time.monotonic() + 900
while time.monotonic() < deadline:
r = requests.get(path, headers=headers, timeout=30)
r.raise_for_status()
status = r.json()["status"]
if status == "completed":
r = requests.get(path + "/content", headers=headers, timeout=120)
r.raise_for_status()
Path("result.mp4").write_bytes(r.content)
break
if status in ("failed", "cancelled"):
raise RuntimeError(status)
time.sleep(5)
else:
raise TimeoutError(job)
https://www.alibabacloud.com/help/en/model-studio/wan3-video-generation-api-reference/接口参数
- 提交一次后按返回 ID 查询,完成后下载。计费时长为输入参考视频秒数与输出秒数之和。
以下为当前线路接受的参数与取值范围,账户额度和上下文限制同时适用。参数可接收不代表相关模型能力已经完成验证。
- 工具调用
- 不支持
- 推理
- 不支持
- 视觉
- 支持
- 流式输出
- 不支持
- JSON 模式
- 不支持
参数与取值
点击参数名即可复制;表格可横向滚动查看全部列。用途栏标明协议差异,不能将同名字段视为跨接口通用。
| 参数 | 类型 | 接收状态 | 取值范围 | 用途 / 协议 |
|---|---|---|---|---|
| 整数 | 可接收 | [-1, 2147483647] | 随机种子,−1 表示随机。 默认值 -1. | |
| 布尔值 | 可接收 | — | 生成音轨。 默认值 true. | |
| 数组 | 可接收 | — | 按顺序提供 type 和 url。首尾帧单独使用。 | |
| 枚举值 | 可接收 | ["adaptive","21:9","16:9","4:3","1:1","3:4","9:16"] | 输出宽高比。 默认值 "adaptive". | |
| 字符串 | 可接收 | — | 视频描述,未提供参考素材时必填。 | |
| 整数 | 可接收 | [-1, 30] | 2–30 秒,或设为 −1 自动决定时长。参考视频与输出总时长最多 30 秒。 默认值 5. | |
| 布尔值 | 可接收 | — | 添加上游水印。 默认值 false. | |
| 枚举值 | 可接收 | ["480P","720P","1080P"] | 输出分辨率。 默认值 "1080P". | |
| 布尔值 | 可接收 | — | 提示词改写,使用文件或网页参考时必须启用。 默认值 true. |
当前配置调用示例
POST /v1/videos
请求示例
{
"model": "wan/wan3.0-video",
"prompt": "A blue paper boat on a calm lake",
"resolution": "480P",
"duration": 2,
"audio": false
}参数版本:fc7ebd1cf1f3
API
安装 requests,设置 ITERACOMPUTE_API_KEY。提交一次后保留任务 ID。脚本用同一把 Key 查询终态并下载视频。超时后可用打印的 ID 继续查询。
Python
import json
import time
import os
from pathlib import Path
import requests
base = "https://api.iteracompute.com/v1"
headers = {"Authorization": "Bearer " + os.environ["ITERACOMPUTE_API_KEY"]}
payload = json.loads("{\n \"model\": \"wan/wan3.0-video\",\n \"prompt\": \"A blue paper boat on a calm lake\",\n \"resolution\": \"480P\",\n \"duration\": 2,\n \"audio\": false\n}")
r = requests.post(base + "/videos", headers=headers, json=payload, timeout=60)
r.raise_for_status()
job = r.json()["id"]
print("Video ID:", job, flush=True)
path = base + "/videos/" + job
deadline = time.monotonic() + 900
while time.monotonic() < deadline:
r = requests.get(path, headers=headers, timeout=30)
r.raise_for_status()
status = r.json()["status"]
if status == "completed":
r = requests.get(path + "/content", headers=headers, timeout=120)
r.raise_for_status()
Path("result.mp4").write_bytes(r.content)
break
if status in ("failed", "cancelled"):
raise RuntimeError(status)
time.sleep(5)
else:
raise TimeoutError(job)价格
美元/秒(参考视频与输出视频时长合计)
480P$0.03
720P$0.06
1080P$0.12
- Model ID
wan/wan3.0-video- 验证范围与来源
查看完整验证范围与来源
2026-11-21 · SG 实测了 480P、720P、1080P,30 秒上限、参考视频时长与输出时长合计扣费,并核对了轮询和下载的账号隔离。
使用限制
- 结果链接有效期为 24 小时。参考视频同时占用时长额度并参与计费。
- 上游支持 480P、720P、1080P,指定输出时长为 2 至 30 秒。传入视频时,输入与输出总时长最多 30 秒。
适用任务
接入工具与指南
常见问题
如何接入?
如何计费?
最新上架
查看入选 New Arrivals 的模型,了解 API 价格、已支持能力与接入方式。
Qwen新上架
Qwen3.7-Plus
qwen/qwen3.7-plus
Qwen3.7-Plus 接收文字与视觉输入,生成文本。
IteraCompute 上线日期
- 输入
- $0.384
- 输出
- $1.536
美元 / 百万 tokens
Alibaba Cloud新上架
Wan 3.0 Prime
wan/wan3.0-video-prime
万相 3.0 Prime 可根据文本和参考素材生成视频。
IteraCompute 上线日期
Qwen新上架
Qwen-Image-3.0-Pro
qwen/qwen-image-3.0-pro
使用 Qwen-Image 生成和编辑图像。
IteraCompute 上线日期