Wan 3.0 Prime 与 Wan 2.6 Flash 对比:生成速度、帧保真度与成本
目标型号:
wan3.0-video-prime·wan2.6-flash
推理接口:https://api.toapis.com/v1/videos/generations
相关阅读:Wan 3.0 视频 API 入门 · Kling Video O1 长视频连续性 · Wan 3.0 参考 · Wan 2.6 Flash 参考 · wan3.0-video-prime 型号指南 · wan2.6-flash 型号指南
1. TL;DR 与能力概览
- 先核对目录:规划稿有时写成
wan-3-prime和wan-2-6-flash。这些字符串不是已文档化的公共 ID。2026-11-20 核对官方生成参考和型号指南页面(HTTP 200),列出wan3.0-video-prime和wan2.6-flash。Prime 与wan3.0-video共用 Wan 3.0 All-in-One 结构;Flash 另有独立参考。 - 同一网关,不同合同:两个 ID 都提交到
POST /v1/videos/generations,并用GET /v1/videos/generations/{id}轮询。普通任务也可以用GET /v1/tasks/{id}查询。官方示例使用https://toapis.com(中国大陆为https://toapis.cn)。本系列其他指南使用https://api.toapis.com。选定一个源站并保持一致。 - 能力划分:Prime 覆盖文生视频、首尾帧、多模态参考、文件或链接,以及视频编辑,时长窗口为 2–30 秒(或
-1)。Flash 只做图生视频和参考视频(r2v):仅提示词的请求会报错,时长为 5、10 或 15 秒。 - 速度与成本:Flash 页面将生成描述为更快,并公布了人民币每秒价表。型号指南快照将 Prime 标为 41.14 credits / 秒,将 Flash 标为 6 credits / 秒。官方页面没有公布实测时延或节省比例。
- 应丢弃的未核实说法:诸如
$0.014/s、每 5 秒$0.070、“节省 53%”、“sub-35s”或“约 14 秒对约 36 秒”等规划稿数字,不是当前 ToAPIs 文档。
2. 已文档化的 ID 与能力对比
在 model 字段中使用公共型号名。不要替换成规划稿别名、连字符变体或模式开关。
| 目录 ID | 在本对比中的角色 | 已文档化的能力 |
|---|---|---|
wan3.0-video-prime | Prime / 更高档的 All-in-One ID | 与 wan3.0-video 同一结构:文生视频、首尾帧、多模态参考、文件或链接、编辑与延长 |
wan3.0-video | 同一结构上的标准 Wan 3.0 ID | 若需要标准全能 SKU,见 Wan 3.0 入门 |
wan2.6-flash | 加速的图生视频与 r2v ID | 根据 image_urls 或 metadata.reference_urls 路由到 i2v-flash 或 r2v-flash。没有仅文本路径 |
wan2.6 | 相关的非 Flash Wan 2.6 ID | 文生视频、图生视频和参考视频,默认包含音频,参数映射不同 |
对路由和保真度有意义的并排字段(这不是时延表):
| 主题 | wan3.0-video-prime | wan2.6-flash |
|---|---|---|
| 文生视频 | 支持(仅提示词) | 不支持——仅提示词的请求会报错 |
| 图像或首尾帧 | image_with_roles(first_frame、last_frame);尾帧必须有首帧 | image_urls——1 张图;不能与 metadata.reference_urls 同时使用 |
| 参考视频 | video_list 最多 5 段,总时长 ≤15 秒,可与参考图片和音频组合 | metadata.reference_urls 路由到 r2v-flash;不能与 image_urls 同时使用 |
| 其他参考 | 参考音频、一个文件或一个网页链接;首尾帧模式与所有这些互斥 | Flash 生成页未文档化这些能力 |
| 时长 | 2–30 秒,或 -1 智能时长(默认 5) | 5、10 或 15 秒(默认 5) |
| 分辨率 | 480p、720p、1080p(默认 1080p) | 720p 或 1080p(默认 1080p);未列出 480p |
| 音频 | 布尔,默认 true | 布尔,默认 true;有声与静音按不同费率计费 |
| 比例 / 宽高比 | ratio(adaptive、16:9、9:16、1:1、4:3、3:4);不要同时发送 aspect_ratio | Flash 生成示例并未像 wan2.6 那样文档化宽高比字段 |
| 编辑 / 延长 | 按提示词分类的编辑与延长;编辑需要 ratio=adaptive、duration=-1、4–30 秒源视频 | 未文档化为 Wan 3.0 风格的编辑路径 |
| 速度表述 | 未公布周转时间 | 官方页面:“更快的生成速度——适合快速预览和迭代” |
两种合同都要求素材为公开的 http:// 或 https:// URL。不要发送 base64。Flash 明确写明 image_urls 不再支持 base64。

图 1:Prime 与 Flash 共用 POST /v1/videos/generations,但已文档化的输入家族和时长窗口不同——按任务选择 ID,然后轮询同一任务 ID。
如果需要的是标准 Wan 3.0 SKU 而不是 Prime,请从 入门指南 开始。若需要非 Flash 的 Wan 2.6 文生视频路径,请使用 wan2.6 及其自己的生成参考。
3. 生产实现:cURL 与 Python
本系列的国际示例使用 https://api.toapis.com。官方文档要求中国大陆用户使用 https://toapis.cn。每个环境只保留一个源站。
步骤 1:Prime 文生视频与 Flash 图生视频的 cURL
# Prime — 文生视频是已文档化的
curl --request POST \
--url https://api.toapis.com/v1/videos/generations \
--header "Authorization: Bearer $TOAPIS_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "wan3.0-video-prime",
"prompt": "An orange cat running through the streets of Tokyo after rain, cinematic camera work",
"duration": 5,
"ratio": "16:9",
"resolution": "1080p",
"audio": true
}'
# Flash — 必须提供 image_urls 或 metadata.reference_urls
curl --request POST \
--url https://api.toapis.com/v1/videos/generations \
--header "Authorization: Bearer $TOAPIS_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "wan2.6-flash",
"image_urls": ["https://example.com/photo.jpg"],
"prompt": "The person comes alive and smiles",
"resolution": "1080p",
"duration": 5,
"audio": true
}'
步骤 2:拒绝非法组合的 Python 助手
下面的片段遵循已文档化的任务状态路径,以及 queued / in_progress / completed / failed 状态。上线前请对照你账户对应的 API 参考确认 id、result.data[0].url 和响应包络。
import os
import time
import requests
API_KEY = os.environ["TOAPIS_API_KEY"]
BASE = "https://api.toapis.com"
ENDPOINT = f"{BASE}/v1/videos/generations"
HEADERS = {
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
}
PRIME_ID = "wan3.0-video-prime"
FLASH_ID = "wan2.6-flash"
def dispatch_compared_model(
model: str,
prompt: str | None = None,
*,
duration: int = 5,
resolution: str = "1080p",
audio: bool = True,
ratio: str | None = None,
image_urls: list[str] | None = None,
reference_urls: list[str] | None = None,
image_with_roles: list[dict] | None = None,
) -> str:
if model not in {PRIME_ID, FLASH_ID}:
raise ValueError("Send wan3.0-video-prime or wan2.6-flash; draft aliases are not documented IDs")
if model == FLASH_ID:
if duration not in {5, 10, 15}:
raise ValueError("wan2.6-flash duration must be 5, 10, or 15")
if resolution not in {"720p", "1080p"}:
raise ValueError("wan2.6-flash resolution must be 720p or 1080p")
if image_urls and reference_urls:
raise ValueError("Flash cannot combine image_urls with metadata.reference_urls")
if not image_urls and not reference_urls:
raise ValueError("wan2.6-flash does not support text-only generation")
if image_urls and len(image_urls) != 1:
raise ValueError("Flash image_urls supports exactly one image")
payload = {
"model": FLASH_ID,
"resolution": resolution,
"duration": duration,
"audio": audio,
}
if prompt:
payload["prompt"] = prompt
if image_urls:
payload["image_urls"] = image_urls
if reference_urls:
payload["metadata"] = {"reference_urls": reference_urls}
else:
if duration != -1 and duration not in range(2, 31):
raise ValueError("Prime duration must be 2–30 or -1")
if resolution not in {"480p", "720p", "1080p"}:
raise ValueError("Prime resolution must be 480p, 720p, or 1080p")
payload = {
"model": PRIME_ID,
"duration": duration,
"resolution": resolution,
"audio": audio,
"ratio": ratio or "16:9",
}
if prompt:
payload["prompt"] = prompt
if image_with_roles:
payload["image_with_roles"] = image_with_roles
res = requests.post(ENDPOINT, headers=HEADERS, json=payload, timeout=30)
res.raise_for_status()
data = res.json()
task_id = data.get("id") or data.get("task_id")
if not task_id:
raise RuntimeError(f"Unexpected submission envelope: {data}")
return task_id
def poll_task(task_id: str, deadline_s: int = 900) -> str:
poll_url = f"{BASE}/v1/videos/generations/{task_id}"
interval = 10.0
start = time.time()
time.sleep(5)
while time.time() - start < deadline_s:
poll = requests.get(poll_url, headers=HEADERS, timeout=15)
if poll.status_code == 429:
retry_after = poll.headers.get("Retry-After")
time.sleep(float(retry_after) if retry_after else min(interval * 2, 120))
continue
poll.raise_for_status()
data = poll.json()
status = data.get("status")
if status == "completed":
return data["result"]["data"][0]["url"]
if status == "failed":
raise RuntimeError(f"Generation failed: {data.get('error')}")
time.sleep(interval)
interval = min(interval * 1.5, 30.0)
raise TimeoutError(f"Task {task_id} exceeded {deadline_s}s; check status before retrying")
if __name__ == "__main__":
flash_id = dispatch_compared_model(
FLASH_ID,
"The person comes alive and smiles",
image_urls=["https://example.com/photo.jpg"],
duration=5,
resolution="720p",
audio=False,
)
print("Flash task:", flash_id)
print("Flash video:", poll_task(flash_id))
不要在这些调用外包一层墙上时钟,并把结果当作厂商基准发布。官方页面并未提供这样的基准。在 expires_at 之前下载文件;状态参考写明保留窗口为 30 天。
4. 错误处理与状态矩阵
下表是诊断起点,并不保证与 ToAPIs 错误码完全一一对应。HTTP 查询成功后仍需读取任务 status。请求错误与 status: failed 的原因(例如 content_policy_rejected、insufficient_user_balance、generation_timeout 或 video_edit_parameters_required)见 错误码参考。
| HTTP 或任务状态 | 常见类别 | 建议操作 |
|---|---|---|
400 | Flash 仅提示词请求、Flash 同时传了 image_urls 与 reference_urls、Prime 将首尾帧与参考素材混用,或使用了未文档化的时长 | 确认该型号已文档化的 ID 及其互斥字段家族 |
401 | 缺少或无效的 API Key | 在 ToAPIs 控制台轮换密钥,并确认 Authorization: Bearer 请求头 |
429 | 速率或并发限制 | 如有 Retry-After 请遵守;加抖动退避;仅在安全时重试 |
5xx 或客户端超时 | 网关或上游暂时问题 | 先查询已有任务 ID 再决定是否重提——超时既不是速度基准,也不能证明失败 |
status: queued 或 in_progress | 不是错误 | 等待并再次轮询;不要把进行中的耗时当成已公布的 SLA |
status: failed | 生成未成功 | 读取 error.code 与 error.message(若有 error.reason 也一并查看)。不要原样重试被策略拒绝的载荷 |
5. 定价与 FinOps
先引用官方快照,再确认账户实时目录。不要用规划稿算术发明节省比例。
Wan 2.6 Flash——摘自 2026-11-20 获取的官方英文生成参考(“Audio vs Silent Pricing”):
| 模式 | 720p 单价 | 1080p 单价 |
|---|---|---|
开启音频(audio: true) | ¥0.3 / 秒 | ¥0.5 / 秒 |
静音(audio: false) | ¥0.15 / 秒 | ¥0.25 / 秒 |
同一页面还指出不同分辨率价格不同,并提示查阅模型市场。当天的 wan2.6-flash 型号指南页面 显示定价参考为 6 credits / 秒,并写明最终计费以当前账户报价为准。
Wan 3.0 Prime——Wan 3.0 生成参考没有公布货币价表。2026-11-20 的 wan3.0-video-prime 型号指南页面 显示定价参考为 41.14 credits / 秒,最终计费以当前账户报价以及当前时长和分辨率规则为准。同一天,标准全能 ID wan3.0-video 显示为 26.3 credits / 秒。这些积分数字是快照,型号指南页也未按分辨率拆分。
请把人民币和积分数字视为快照,它们可能会变化。不要自行把积分换算成货币,也不要沿用规划稿中的美元单价。
- 先按任务选择 ID,再在同等工作量上比较成本。 一段 5 秒、720p、静音的 Flash 预览,与一段 20 秒、1080p 的 Prime 文生视频不是同一 SKU。请在目录中按相同的时长、分辨率和音频设置比较。
- Flash 的音频是已文档化的成本杠杆。 官方价表显示,在 720p 和 1080p 下,
audio为 true 时的人民币单价是静音的两倍。这是合同陈述,不是实测质量声明。 - 展示价格不是渠道保证。 在预估批量成本之前,用
GET /v1/models?type=video和实时报价确认两个 ID。
6. 常见问题
详见 frontmatter 中的 FAQ。摘要:发送 wan3.0-video-prime 和 wan2.6-flash,不要发送规划稿别名;Flash 不能做仅文本生成;时长和分辨率窗口不同;官方页面把 Flash 描述得更快,但未公布时延数字;引用 Flash 人民币价表和型号指南积分快照,再确认账户目录。
7. 行动清单
- 在 ToAPIs 开发者门户 创建密钥。
- 通过
GET /v1/models?type=video确认当前密钥能看到wan3.0-video-prime和wan2.6-flash——不要发送wan-3-prime或wan-2-6-flash。 - 用 5 秒文生视频请求对 Prime 做冒烟测试,并用单个公开的
image_urls对 Flash 做冒烟测试(若在核对静音 SKU,可尝试 720p 且audio: false)。 - 以有界超时轮询
GET /v1/videos/generations/{id},并在expires_at之前下载结果。 - 下一步:参阅 Wan 3.0 入门 了解 All-in-One 参数,查看 Prime 与 Flash 型号指南了解实时目录状态;若改为串联较短的已文档化片段,参阅 Kling Video O1 连续性指南。







