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 連續性指南。







