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 Video 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を使います。オリジンは 1 つに揃えてください。 - 能力の分かれ目: 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 | 標準 All-in-One 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 と併用不可 |
| その他の参照 | 参照音声、ファイル 1 つ、または Web リンク 1 つ。先頭・末尾フレームモードはこれらすべてと排他 | Flash 生成ページでは文書化されていない |
| 尺 | 2〜30 秒、またはスマート尺の -1(デフォルト 5) | 5、10、または 15 秒(デフォルト 5) |
| 解像度 | 480p、720p、1080p(デフォルト 1080p) | 720p または 1080p(デフォルト 1080p)。480p は未記載 |
| 音声 | ブール、デフォルト true | ブール、デフォルト true。有音と無音は異なるレートで課金 |
| アスペクト / ratio | 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 をポーリングしてください。
Prime ではなく標準の Wan 3.0 SKU が必要なら、クイックスタート から始めてください。非 Flash の Wan 2.6 テキストから動画経路が必要なら、wan2.6 とその生成リファレンス を使います。
3. 本番実装: cURL と Python
本シリーズの国際向け例は https://api.toapis.com を使います。公式ドキュメントは中国本土の利用者に https://toapis.cn を指定しています。環境ごとにオリジンは 1 つに揃えます。
ステップ 1: Prime のテキストから動画と、Flash の画像から動画を cURL で送る
# Prime — text-to-video is documented
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 or metadata.reference_urls is required
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 キー欠落または無効 | 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 / 秒 を示し、最終課金は現行アカウント見積もりと現行の尺・解像度規則に従うと述べていました。同日、標準 All-in-One ID wan3.0-video は 26.3 credits / 秒 でした。これらのクレジット数字はスナップショットで、モデルガイド頁は解像度別にも分けていません。
人民元とクレジットの数字はスナップショットとして扱い、変わる可能性があります。クレジットを自分で通貨換算せず、企画ドラフトの USD 単価も再利用しないでください。
- まずジョブに ID を合わせ、同じ作業量でコストを比較する。 5 秒・無音・720p の Flash プレビューは、20 秒・1080p の Prime テキストから動画と同じ SKU ではありません。カタログで同じ尺・解像度・音声設定を比較してください。
- Flash の音声は文書化されたコストレバーです。 公式表では、720p でも 1080p でも、
audioが true のときの人民元単価は無音の 2 倍です。これは契約上の記述であり、実測の品質主張ではありません。 - 表示価格はチャネル保証ではありません。 バッチを見積もる前に、
GET /v1/models?type=videoと現行見積もりで両方の ID を確認してください。
6. よくある質問
frontmatter の FAQ を参照してください。要約: wan3.0-video-prime と wan2.6-flash を送り、ドラフト別名は送らない。Flash はテキストのみ生成ができない。尺と解像度の幅は異なる。公式ページは Flash をより速いと述べるがレイテンシ数字は公開していない。Flash の人民元表とモデルガイドのクレジットスナップショットを引用し、アカウントカタログで確認する。
7. アクションチェックリスト
- ToAPIs Developer Portal でキーを作成する。
-
GET /v1/models?type=videoでキーにwan3.0-video-primeとwan2.6-flashが見えることを確認する。wan-3-primeやwan-2-6-flashは送らない。 - Prime は 5 秒のテキストから動画で、Flash は公開
image_urls1 件でスモークテストする(無音 SKU を確認するなら 720p かつaudio: false)。 - 期限付きで
GET /v1/videos/generations/{id}をポーリングし、expires_atより前に結果をダウンロードする。 - 次の一歩: All-in-One パラメータは Wan 3.0 クイックスタート、現行カタログは Prime と Flash のモデルガイド。短い文書化セグメントを連鎖するなら Kling Video O1 連続性ガイド。







