ToAPIs
    ホームToAPIs
    画像生成GPT Image 2.6、Gemini、FLUX…動画生成Seedance、Veo、Kling、Sora…チャット・文章作成GPT-5.6、Claude、DeepSeek…音声・音楽ナレーション、音声合成、音楽
    新着Seedance 2.5
    料金API ドキュメントMCP
    ブログ代替製品
    ログイン無料で試す
    すべてのモデル料金API ドキュメントMCPブログ代替製品
    ログイン無料で試す

    言語

    Esc
    • Seedance 2.5動画生成
    • GPT Image 2画像生成
    • GPT Image 2.6画像生成
    • GPT Image 2.5画像生成
    • Veo 3.1 Fast動画生成
    • Kling 3.0 Turbo動画生成
    • Kling V4 Flash動画生成
    • Grok Video 1.5動画生成
    • Nano Banana 2画像生成
    • Seedream 5.5画像生成
    • FLUX画像生成
    • Sora 2動画生成
    • すべての画像モデルカテゴリ
    • すべての動画モデルカテゴリ
    • GPT-5.6 Solチャット・コーディング
    • Claude Opus 4.8チャット・コーディング
    • Claude Opus 4.7チャット・コーディング
    • DeepSeek V4 ProDeepSeek · テキスト
    • Gemini Omni 1.1 FlashGoogle · マルチモーダル
    1. ホーム
    2. ブログ
    3. チュートリアル
    4. Alibaba Wan 3.0 Video API:次世代動画生成の始め方
    すべての記事に戻る
    tutorial2026-11-2011 分で読める

    Alibaba Wan 3.0 Video API:次世代動画生成の始め方

    ToAPIs 上の wan3.0-video と wan3.0-video-prime の本番クイックスタート。1 つの All-in-One エンドポイント、先頭・末尾フレームと参照メディアの排他、ファイルまたはリンク参照、動画編集の制約、文書化されたポーリング経路を扱います。

    ToAPIs Engineering & Evaluation Team
    Wan 3.0Video APITutorialText-to-VideoAlibaba
    TL;DR - 要点まとめ
    • 文書化された公開 ID は wan3.0-video(標準 All-in-One)と wan3.0-video-prime です。企画ドラフトの wan-3-prime は現行契約ではありません。両 ID は Wan 3.0 生成リファレンス上で同じリクエストスキーマを共有し、Prime 専用エンドポイントはありません。
    • Bearer API キーで POST /v1/videos/generations に送り、タスク id を保存して GET /v1/videos/generations/{id} をポーリングします。通常タスクは GET /v1/tasks/{id} でも照会できます。公式例は https://toapis.com(中国本土は https://toapis.cn)です。
    • duration は 2〜30 秒、またはスマート尺の -1 です。解像度は 480p、720p、1080p(デフォルト 1080p)。ratio か aspect_ratio のどちらか一方だけを使います。先頭・末尾フレームモードは参照画像・動画・音声・ファイル・リンクと混ぜられません。
    • 画像、動画、音声、ファイル、ページは公開 http(s) URL で送ってください。base64 やローカルパスは送らないでください。動画編集は ratio=adaptive かつ duration=-1、ソースは 4〜30 秒が必要です。違反は video_edit_parameters_required で失敗します。
    • 未検証のドラフトドル価格は再利用しないでください。2026-11-20 のモデルガイドスナップショットは wan3.0-video が 26.3 credits / 秒、wan3.0-video-prime が 41.14 credits / 秒でした。アカウントカタログの現行見積もりで確認してください。

    Alibaba Wan 3.0 Video API:次世代動画生成の始め方

    対象モデル: wan3.0-video(任意の姉妹 ID: wan3.0-video-prime)
    推論エンドポイント: https://api.toapis.com/v1/videos/generations
    関連: Wan 3.0 Prime 対 Wan 2.6 Flash · Kling Video O1 長尺連続性 · Wan 3.0 リファレンス · wan3.0-video モデルガイド · wan3.0-video-prime モデルガイド


    1. TL;DR と性能概要

    • まずカタログを確認する: 企画ドラフトはときどき wan-3-prime と書きます。これは文書化された公開 ID ではありません。2026-11-20 に公式 Wan 3.0 生成リファレンス(HTTP 200)を確認したところ、wan3.0-video と wan3.0-video-prime が挙げられていました。両モデルはそのページの同じ All-in-One API を使います。独立した Prime 専用ドキュメントパスはありませんでした。
    • 契約: POST /v1/videos/generations に非同期送信し、GET /v1/videos/generations/{id} を completed または failed までポーリングします。通常タスクは GET /v1/tasks/{id} でも照会できます。公式例は https://toapis.com(中国本土は https://toapis.cn)です。本シリーズの他ガイドは https://api.toapis.com を使います。オリジンは 1 つに揃えてください。
    • 1 つのスキーマ上の複数モード: テキストから動画、先頭フレームまたは先頭・末尾フレーム制御、参照画像・動画・音声の併用生成、単一ファイルまたは公開 Web ページ、参照クリップからの編集または延長です。先頭・末尾フレームモードと参照アセットモードは互排他です。
    • メディア: 公開の http:// または https:// URL だけを送ってください。ローカルファイルは先にアップロードし、返却 URL を使います。base64 やローカルパスは送らないでください。prompt とメディアアセットの少なくとも一方が必要です。
    • 捨てるべき未検証の主張: 5 秒あたり $0.150 といったドラフト単価は、現行の ToAPIs 文書ではありません。アカウントで現行レートとチャネル対応を確認してください。

    2. 公式 Wan 3.0 ID、パラメータ、組み合わせ規則

    model フィールドには 2 つの公開モデル名のいずれかを使います。ドラフト別名に置き換えたり、Prime モードフラグを発明したりしないでください。

    カタログ ID本ガイドでの役割文書化されたジョブ
    wan3.0-videoデフォルト / 標準 All-in-One IDテキストから動画、先頭・末尾フレーム、マルチモーダル参照、ファイルまたはリンク、編集と延長
    wan3.0-video-prime同じスキーマ上の Prime 姉妹 IDwan3.0-video と同じリクエスト構造。カタログにあり、Prime SKU を意図するときだけ選ぶ
    wan2.6関連する以前の Wan ID。Wan 2.6 生成リファレンス を参照テキストから動画、画像から動画、参照動画。パラメータマップが異なる(480p なし、尺は 5/10/15)

    主なリクエストフィールド(両 Wan 3.0 ID で共通):

    フィールド文書化された値注記
    prompt文字列内容、動き、カメラ、音。prompt とメディアアセットの少なくとも一方が必要。配列順で「image 1」「video 1」「audio 1」と参照
    duration2〜30 の整数、または -1デフォルト 5。-1 はスマート尺で、モデルが長さを決める
    ratioadaptive(デフォルト)、16:9、9:16、1:1、4:3、3:4aspect_ratio は互換エイリアス。両方は送らない
    resolution480p、720p、1080p(デフォルト 1080p)この契約では 3 段階すべてが文書化されている
    audioブール、デフォルト trueデフォルトで音声あり
    watermarkブール、デフォルト falseデフォルトオフ
    prompt_extendブール、デフォルト trueLLM による書き直しは短いプロンプトを改善し、レイテンシも増やす。原文のまま使うなら false
    seed任意整数同じパラメータとシードで近い結果を再現しやすくする
    image_with_roles{url, role} 配列role は first_frame または last_frame。各最大 1。last_frame には first_frame が必要
    reference_images最大 10 の公開画像 URL先頭・末尾フレームと混ぜられない
    video_list最大 5 本、合計尺 ≤15 秒各項目は {"video_url": "..."}
    audio_with_roles最大 5 本、合計 ≤15 秒各項目は {url, role: "reference_audio"}
    metadata.mediafile 1 つか link 1 つ{type, url}。ファイルとリンクは併用できず、先頭・末尾フレームモードとも混ぜられない
    disable_nsfwブール、デフォルト true上流には転送されない ToAPIs プラットフォームパラメータ。明示的な JSON false だけが、アカウントと販売地域の条件を満たすときにフォールバックを有効化。中国本土では常に無効

    公式表のアセット組み合わせ規則:

    リクエスト内容対応注記
    プロンプトのみはいテキストから動画
    先頭フレームのみはい先頭フレーム制御
    先頭と末尾フレームはい末尾フレームは単独では使えない
    参照画像と参照動画はい参照音声とも組み合わせ可能
    先頭フレームと参照動画いいえ先頭・末尾フレームモードと参照アセットモードは互排他
    ファイルと Web リンクいいえ互排他

    「Wan 3.0 cannot mix first/last frames with reference assets/files/web pages in the same request.」のようなメッセージが返ったら、どちらか一方の系統を外して再送してください。

    動画編集は別エンドポイントではなく、プロンプトで分類される経路です。編集意図(たとえば “edit the video”、“remove”、“replace”)を含め、参照クリップを渡します。これらのジョブは ratio を adaptive、duration を -1 にし、入力は 4〜30 秒である必要があります。延長は “extend” や “continue” などの表現を使い、duration を -1、またはソース尺+延長(合計 ≤ 30 秒)にします。

    空のマルチモーダルパネルが六角形のゲートウェイを通り、1 つの出力フレームに合流する

    図 1: 文書化された Wan 3.0 ペイロードを POST /v1/videos/generations に送り、同じタスク id をポーリングし、status が completed になってから result.data[0].url を読む。

    Wan 2.6 Flash との能力・コスト比較は Wan 3.0 Prime 対 Wan 2.6 Flash を見てください。別ファミリーで 3〜10 秒ウィンドウの長尺連続性は Kling Video O1 ガイド です。


    3. 本番実装: cURL と Python

    本シリーズの国際向け例は https://api.toapis.com を使います。公式ドキュメントは中国本土の利用者に https://toapis.cn を指定しています。環境ごとにオリジンは 1 つに揃えます。

    ステップ 1: テキストから動画を cURL で送る

    bash
    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",
        "prompt": "An orange cat running through the streets of Tokyo after rain, cinematic camera work",
        "duration": 5,
        "ratio": "16:9",
        "resolution": "1080p",
        "audio": true,
        "watermark": false
      }'
    

    先頭・末尾フレームのリクエストは image_with_roles を使い、参照メディア、ファイル、リンクを含めてはいけません。

    bash
    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",
        "prompt": "The camera pushes in naturally as the person transitions from standing to smiling and waving",
        "duration": 8,
        "ratio": "adaptive",
        "resolution": "1080p",
        "image_with_roles": [
          {"url": "https://example.com/first-frame.png", "role": "first_frame"},
          {"url": "https://example.com/last-frame.png", "role": "last_frame"}
        ]
      }'
    

    ステップ 2: Python ヘルパーとポーラー

    このスニペットは文書化されたタスク状態パスと、queued / in_progress / completed / failed に従います。出荷前に、アカウント向け API リファレンスで id、result.data[0].url、エンベロープを確認してください。

    python
    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",
    }
    
    DOCUMENTED_IDS = {"wan3.0-video", "wan3.0-video-prime"}
    RATIOS = {"adaptive", "16:9", "9:16", "1:1", "4:3", "3:4"}
    RESOLUTIONS = {"480p", "720p", "1080p"}
    
    
    def dispatch_wan30(
        prompt: str | None = None,
        *,
        model: str = "wan3.0-video",
        duration: int = 5,
        ratio: str = "16:9",
        resolution: str = "1080p",
        audio: bool = True,
        watermark: bool = False,
        prompt_extend: bool | None = None,
        image_with_roles: list[dict] | None = None,
        reference_images: list[str] | None = None,
        video_list: list[dict] | None = None,
        audio_with_roles: list[dict] | None = None,
        media: list[dict] | None = None,
    ) -> str:
        if model not in DOCUMENTED_IDS:
            raise ValueError("Send wan3.0-video or wan3.0-video-prime; wan-3-prime is not a documented public ID")
        if duration != -1 and duration not in range(2, 31):
            raise ValueError("duration must be 2–30 or -1")
        if ratio not in RATIOS:
            raise ValueError("unsupported ratio")
        if resolution not in RESOLUTIONS:
            raise ValueError("resolution must be 480p, 720p, or 1080p")
        roles = [item.get("role") for item in (image_with_roles or [])]
        if "last_frame" in roles and "first_frame" not in roles:
            raise ValueError("last_frame requires first_frame")
        has_frames = bool(image_with_roles)
        has_refs = any([reference_images, video_list, audio_with_roles, media])
        if has_frames and has_refs:
            raise ValueError("first/last-frame mode cannot mix with reference assets, files, or links")
        if media and len(media) > 1:
            raise ValueError("a single request accepts at most one file or one web page")
        if media and len({item.get("type") for item in media}) > 1:
            raise ValueError("file and link cannot be used together")
        if not prompt and not has_frames and not has_refs:
            raise ValueError("provide a prompt or at least one media asset")
        if reference_images and len(reference_images) > 10:
            raise ValueError("reference_images is documented as at most 10")
        if video_list and len(video_list) > 5:
            raise ValueError("video_list is documented as at most 5 clips")
        if audio_with_roles and len(audio_with_roles) > 5:
            raise ValueError("audio_with_roles is documented as at most 5 clips")
        payload: dict = {
            "model": model,
            "duration": duration,
            "ratio": ratio,
            "resolution": resolution,
            "audio": audio,
            "watermark": watermark,
        }
        if prompt:
            payload["prompt"] = prompt
        if prompt_extend is not None:
            payload["prompt_extend"] = prompt_extend
        if image_with_roles:
            payload["image_with_roles"] = image_with_roles
        if reference_images:
            payload["reference_images"] = reference_images
        if video_list:
            payload["video_list"] = video_list
        if audio_with_roles:
            payload["audio_with_roles"] = audio_with_roles
        if media:
            payload["metadata"] = {"media": media}
        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__":
        task_id = dispatch_wan30(
            "An orange cat running through the streets of Tokyo after rain, cinematic camera work",
            duration=5,
            ratio="16:9",
            resolution="1080p",
        )
        print("Task:", task_id)
        print("Video:", poll_task(task_id))
    

    パラメータ変更と文言変更を区別できるよう、プロンプトテンプレートの版をタスク記録の横に保存してください。expires_at より前にダウンロードします。ステータスリファレンスは 30 日の保持期間を文書化しています。prompt_extend(デフォルト)を有効にすると、短いプロンプトで追加レイテンシが起き得ます。公式ページはこれを定性的に述べ、実測遅延は公開していません。


    4. エラー処理とステータス行列

    下表は診断の出発点であり、ToAPIs のエラーコードと完全に一致することを保証しません。HTTP 照会が成功しても、タスク status を読む必要があります。リクエストエラーと status: failed の理由(content_policy_rejected、insufficient_user_balance、generation_timeout、video_edit_parameters_required など)は エラーリファレンス を見てください。

    HTTP またはタスク状態よくある分類推奨アクション
    400不正フィールド、先頭・末尾フレームと参照アセットの混在、ratio と aspect_ratio の併用、またはファイルとリンクの併用wan3.0-video または wan3.0-video-prime を確認し、排他な一方を外し、公開 URL だけを使う
    401API キー欠落または無効ToAPIs ダッシュボードでキーをローテーションし、Authorization: Bearer ヘッダを確認
    429レートまたは同時実行制限Retry-After があれば遵守。ジッタ付きバックオフ。安全なときだけ再試行
    5xx またはクライアントタイムアウトゲートウェイまたは上流の一時障害再送する前に既存のタスク id を照会
    status: queued または in_progressエラーではない待って再ポーリング。prompt_extend はレイテンシを増やすことがある
    status: failed で video_edit_parameters_required編集制約を満たしていないratio を adaptive、duration を -1 にし、4〜30 秒のソースを使う
    status: failed(その他)生成は成功していないerror.code と error.message(あれば error.reason)を読む。ポリシー拒否のペイロードを変えずに再送しない

    WaitTime=min⁡(MaxWait,BaseInterval×2attempt)+Uniform(0,1)\text{WaitTime} = \min(\text{MaxWait}, \text{BaseInterval} \times 2^{\text{attempt}}) + \text{Uniform}(0, 1)WaitTime=min(MaxWait,BaseInterval×2attempt)+Uniform(0,1)


    5. 料金と FinOps

    Wan 3.0 生成リファレンスはドル表もクレジット表も公開していません。2026-11-20 取得のモデルガイドは、wan3.0-video の料金参考を 26.3 credits / 秒、wan3.0-video-prime を 41.14 credits / 秒 と示し、最終課金は現行アカウント見積もりと現行の尺・解像度規則に従うと述べていました。これらのクレジット数字はスナップショットであり、すべての解像度やモードの契約ではありません。クレジットを自分で通貨換算せず、企画ドラフトのドル単価も再利用しないでください。

    Estimated cost=successful billable seconds×current account rate for that model and resolution\text{Estimated cost} = \text{successful billable seconds} \times \text{current account rate for that model and resolution}Estimated cost=successful billable seconds×current account rate for that model and resolution

    • 中程度の尺の wan3.0-video から始める(例: 5 秒)。プロンプトとアセットの組み合わせが安定してから、解像度を上げたり Prime に切り替えたりします。
    • スマート尺(-1)と prompt_extend は、モデルが行う仕事を変えます。 文書化された能力であり、固定のジョブ単価やレイテンシを仮定する理由にはなりません。
    • 表示価格はチャネル保証ではありません。 バッチを見積もる前に、GET /v1/models?type=video とアカウントカタログで ID と現行見積もりを確認してください。

    6. よくある質問

    frontmatter の FAQ を参照してください。要約: wan3.0-video または wan3.0-video-prime を送り、wan-3-prime は送らない。先頭・末尾フレームは参照アセットと混ぜられない。尺は 2〜30 秒または -1。編集には ratio=adaptive と duration=-1 が必要。generations の状態パスを必ずポーリングし、タスク id を保存する。


    7. アクションチェックリスト

    • ToAPIs Developer Portal でキーを作成する。
    • GET /v1/models?type=video でキーに wan3.0-video(必要なら wan3.0-video-prime も)が見えることを確認する。wan-3-prime は送らない。
    • duration: 5、ratio: "16:9"、resolution: "1080p" で cURL スニペットをスモークテストする。
    • 期限付きで GET /v1/videos/generations/{id} をポーリングし、expires_at より前に結果をダウンロードする。
    • 次の一歩: 文書化された能力とコスト比較は Wan 3.0 Prime 対 Wan 2.6 Flash、現行カタログは wan3.0-video モデルガイド。

    記事内で紹介されたモデルとAPI

    UnknownVIDEO

    wan3.0-video

    現在のレート:26.3 credits /second
    モデル解説オンライン試用APIキーを取得
    UnknownVIDEO

    wan3.0-video-prime

    現在のレート:41.14 credits /second
    モデル解説オンライン試用APIキーを取得
    AlibabaVIDEO

    wan2.6

    現在のレート:12 credits /second
    モデル解説オンライン試用APIキーを取得

    関連記事

    tutorial2026-11-18T10:00:00+08:0011 分で読める

    Kling 3.0 Omni API 徹底解説:マルチショット動画生成と物理的な連続性

    ToAPIs 上の kling-v3-omni 実践ガイド。公式 Omni プレースホルダ、image_list / video_list / element_list、先頭・末尾フレーム、文書化されたポーリング経路を扱い、未文書の shots 配列は使いません。

    TO
    ToAPIs Engineering & Evaluation Team
    #Kling Omni
    tutorial2026-11-17T10:00:00+08:009 分で読める

    Grok-Video-3 API 実践ガイド:xAI ビデオエンジンで先に確認すべき現在の契約

    ToAPIs で xAI Grok Video を呼ぶ実践ガイド。公開カタログに載っているのは grok-video-1.0 と grok-video-1.5 であり grok-video-3 ではないこと、現行の generations 契約、モード、ポーリング経路を整理します。

    TO
    ToAPIs Engineering & Evaluation Team
    #Grok Video
    comparison2026-11-20T10:00:00+08:0011 分で読める

    Wan 3.0 Prime 対 Wan 2.6 Flash:生成速度、フレーム忠実度、コスト

    ToAPIs 上の wan3.0-video-prime と wan2.6-flash を契約に忠実に比較します。文書化されたモード、尺と解像度の幅、公式料金スナップショット、そして公開ページが数値のレイテンシや節約率を支持しない理由です。

    TO
    ToAPIs Engineering & Evaluation Team
    #Wan 3.0 Prime
    ToAPIs
    ホームToAPIs
    エンタープライズ向け AI API ゲートウェイ。GPT-5、Claude、Gemini など 200 以上のモデルに 1 つの API でアクセスできます。

    人気モデル

    • Seedance 2.5 API
    • Seedance 2.0 API
    • Veo 3.1 Fast API
    • Kling 3.0 Turbo API
    もっと見る折りたたむ
    • GPT Image 2 API
    • Claude Opus 4.8 API
    • Nano Banana 2 API
    • Seedance 2 Mini API
    • すべてのモデル

    API カテゴリ

    • AI 画像生成 API
    • AI 動画生成 API
    • テキストから動画 API
    • 画像から動画 API
    もっと見る折りたたむ
    • AI 画像編集 API
    • 言語・推論モデル API
    • すべての API ツール →

    代替サービス

    代替サービス
    • Kie.ai の代替
    • Fal.ai 代替
    • OpenRouter の代替
    • Replicate 代替
    • Wavespeed AI 代替
    • すべてのサービス比較 →

    おすすめガイド

    おすすめガイド
    • Seedance 2.0 と 2.5 の料金比較
    • 低コスト Seedance API ガイド
    • MiniMax H3 連携ガイド
    • Seedance 2 無料テストキー
    • Seedance 2 API クイックスタート
    • すべての技術記事 →

    開発者・プラットフォーム

    開発者・プラットフォーム
    • API ドキュメント
    • MCP
    • 料金
    • モデルプレイグラウンド
    • LLMs.txt
    • サポートへ連絡
    • モデルガイド一覧
    運営主体:
    鯨樞智能科技有限公司
    JINGSHU INTELLIGENT LIMITED
    登記住所:
    ROOM 5042, 5/F, YAU LEE CENTRE, NO.45, HOI YUEN ROAD, KWUN TONG, KOWLOON, HONG KONG
    プライバシー利用規約利用ポリシーデータ削除ポリシーデータ保持ポリシー委託先とデータリージョン請求と返金Cookie ポリシーサイトマップ概要

    © 2026 ToAPIs. All rights reserved.