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. Grok-Video-3 API 実践ガイド:xAI ビデオエンジンで先に確認すべき現在の契約
    すべての記事に戻る
    tutorial2026-11-179 分で読める

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

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

    ToAPIs Engineering & Evaluation Team
    Grok VideoVideo APIxAIText-to-VideoTutorial
    TL;DR - 要点まとめ
    • 公開カタログのスナップショット日付は 2026-11-10 です。2026-11-17 にドキュメントとモデルガイドを再確認しても、公開のモデル ID として grok-video-3 は存在しません。文書化されている Grok Video の ID は grok-video-1.0 と grok-video-1.5 です。
    • Bearer API キーで POST /v1/videos/generations に投入し、タスク id を保存して GET /v1/videos/generations/{id} をポーリングします。文書化されていない /videos/tasks は使わないでください。
    • grok-video-1.5 は text_to_video、first_frame_image_to_video、reference_images_to_video の 3 モードを明示しています。video_generation_mode は実際に送るメディアと一致させてください。
    • 画像は公開の http(s) URL のみです。ローカルファイルは先に POST /v1/uploads/images でアップロードします。これらの生成 API は base64 を受け付けません。
    • 企画ドラフトの未検証な秒単価や SLA 数値を再利用しないでください。ショットリストを見積もる前に、アカウント上の現行レートとチャネル可否を確認してください。

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

    対象モデル: grok-video-1.5、grok-video-1.0
    推論エンドポイント: https://api.toapis.com/v1/videos/generations
    関連記事: OpenAI 互換アクセス · Grok Imagine 公式チャネル API · Hailuo 2.3 動画ガイド · Grok Video 1.5 リファレンス


    1. クイックスタートと性能概要 (TL;DR)

    • まずカタログを見る: Grok Video 3 の実践記事であっても、呼び出しは ToAPIs が実際に公開している ID から始めます。2026-11-10 付けの公開プロダクションカタログスナップショットは、openai-video エンドポイントに grok-video-1.0 と grok-video-1.5 を掲載しています。2026-11-17 に grok-video-3 のドキュメントとモデルガイド URL を確認したところ、結果は HTTP 404 でした。
    • 契約: POST /v1/videos/generations に非同期で投入し、GET /v1/videos/generations/{id} を completed または failed までポーリングします。公式例は https://toapis.com(中国本土は https://toapis.cn)です。本シリーズの他ガイドは https://api.toapis.com を使います。オリジンは 1 つにそろえてください。
    • モード: grok-video-1.5 は text_to_video、first_frame_image_to_video、reference_images_to_video を文書化しています。video_generation_mode を明示し、参照画像 1 枚がレガシーなファーストフレーム扱いにならないようにします。
    • メディア: 公開の http:// または https:// URL だけを送ってください。ローカルファイルは POST /v1/uploads/images でアップロードし、返却された data.url を使います。base64 は送らないでください。
    • 捨てるべき未検証の主張: 企画ドラフトにある grok-video-3 という ID、99.95% の SLA、固定の $0.030–$0.038 /秒、あるいは将来の音声リリース日は、現行の ToAPIs ドキュメントではありません。ライブの料金とチャネル可否はアカウントで確認してください。

    2. 現行の Grok Video ID と生成モード

    model フィールドには公開モデル名を使います。サプライヤ固有名、URL スラッグ、未公開の grok-video-3 に置き換えないでください。

    カタログ ID文書化されたジョブ尺(ドキュメント)解像度画像入力
    grok-video-1.5テキスト、ファーストフレーム、または 1–7 枚の参照画像。video_generation_mode で指定整数 1–15 秒参照モードは 480p または 720p。テキストとファーストフレームはチャネル対応時に 1080pファーストフレーム: image または input_reference でちょうど 1 枚。参照モード: 1–7 枚の reference_images
    grok-video-1.0テキストから動画、画像から動画生成リファレンス: 1–15 秒(デフォルト 8)。モデルガイド / Playground: 利用中のバリアントは 6 秒 上限480p、720p任意の image と reference_images。合計最大 8 枚

    grok-video-1.5 の新規連携ではモードを明示してください。

    video_generation_mode必須入力省略すべきもの
    text_to_video空でない promptあらゆる画像フィールド
    first_frame_image_to_videoimage または input_reference にちょうど 1 枚のファーストフレーム両方の別名に矛盾する値を入れない。アカウントのリファレンスが別途述べない限り、参照リストを同時に送らない
    reference_images_to_videoprompt と 1–7 枚の reference_images(文字列または {"url":"..."} オブジェクト)このモードなしで reference_images を 1 枚だけ送ること。レガシーな単一画像入力はファーストフレーム動作のままです

    見積もりの成功は、生成チャネルが開いている保証にはなりません。モードは互換チャネルで有効化されたときだけ使え、非対応の組み合わせはタスク作成前に拒否されることがあります。

    Grok Video リファレンスでよく出るアスペクト比は 16:9、9:16、3:2、2:3、1:1 です。利用可否はチャネル依存なので、その ID で確認済みの値を送ってください。

    空白の入力フレームが六角形ゲートウェイを通り、1 枚の出力フレームになる図

    図 1: プロンプト(と任意の公開画像 URL)を POST /v1/videos/generations に送り、同じタスク id をポーリングし、status が completed になってから result.data[0].url を読みます。

    公式チャネルの Grok Imagine で動画延長などが必要なら、別の ID ファミリーです。Imagine 公式チャネルガイド を参照してください。尺の体系が異なる別契約としては Hailuo 2.3 ガイド があります。


    3. 本番実装: cURL と Python

    本シリーズの国際向け例は https://api.toapis.com を使います。公式ドキュメントは中国本土ユーザーに https://toapis.cn を指示しています。環境ごとにオリジンは 1 つにそろえます。パス、モデル ID、Bearer ヘッダーは同じです。

    ステップ 1: cURL で grok-video-1.5 を投入する

    bash
    curl -X POST "https://api.toapis.com/v1/videos/generations" \
      -H "Authorization: Bearer $TOAPIS_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "grok-video-1.5",
        "prompt": "A cinematic product shot with a slow camera push-in",
        "video_generation_mode": "text_to_video",
        "duration": 8,
        "resolution": "720p",
        "aspect_ratio": "16:9"
      }'
    

    ファーストフレームジョブは同じパスで "video_generation_mode": "first_frame_image_to_video" と image URL を使います。参照画像ジョブは "video_generation_mode": "reference_images_to_video" と reference_images を設定し、resolution は 480p または 720p のままにします。

    ステップ 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",
    }
    
    
    def dispatch_grok_video(
        prompt: str,
        *,
        model: str = "grok-video-1.5",
        mode: str = "text_to_video",
        duration: int = 8,
        resolution: str = "720p",
        aspect_ratio: str = "16:9",
        image_url: str | None = None,
        reference_images: list[str] | None = None,
    ) -> str:
        if model == "grok-video-3":
            raise ValueError("grok-video-3 is not a current public catalog ID")
        if mode == "reference_images_to_video" and resolution not in {"480p", "720p"}:
            raise ValueError("reference mode is documented as 480p or 720p")
        payload = {
            "model": model,
            "prompt": prompt,
            "duration": duration,
            "resolution": resolution,
            "aspect_ratio": aspect_ratio,
        }
        if model == "grok-video-1.5":
            payload["video_generation_mode"] = mode
        if mode == "text_to_video" and (image_url or reference_images):
            raise ValueError("text_to_video rejects image fields")
        if mode == "first_frame_image_to_video":
            if not image_url:
                raise ValueError("first-frame mode requires exactly one image URL")
            payload["image"] = image_url
        if mode == "reference_images_to_video":
            refs = reference_images or []
            if not (1 <= len(refs) <= 7):
                raise ValueError("reference mode requires 1-7 image URLs")
            payload["reference_images"] = refs
        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 = 600) -> 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_grok_video(
            "A cinematic product shot with a slow camera push-in",
            mode="text_to_video",
            duration=8,
            resolution="720p",
        )
        print("Task:", task_id)
        print("Video:", poll_task(task_id))
    

    プロンプトテンプレートのバージョンをタスク記録と一緒に保存し、モデルやモードの変更と文言の変更を区別できるようにしてください。expires_at の前にファイルをダウンロードします。ステータスリファレンスは 30 日の保持期間を記載しています。


    4. エラー処理とステータスマトリクス

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

    HTTP またはタスク状態よくある分類推奨アクション
    400無効なフィールド、モードとメディアの不一致、非対応の組み合わせ正確なカタログ ID、video_generation_mode が画像フィールドと一致していること、参照モードが 480p または 720p であること、画像が公開 URL であることを確認する
    401API キーの欠落または無効ToAPIs ダッシュボードでキーをローテーションし、Authorization: Bearer ヘッダーを確認する
    429レートまたは同時実行の制限Retry-After があれば従い、ジッター付きでバックオフし、安全なときだけ再試行する
    5xx またはクライアントタイムアウトゲートウェイまたは上流の一時障害再投入の前に既存のタスク id を照会する
    status: queued または in_progressエラーではない待って再ポーリングする。2 つ目のジョブを作らない
    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 ROI

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

    • 企画ドラフトの単価を再利用しないでください。 grok-video-1.5 の API リファレンスは、料金は現行アカウントと SKU 設定に従い、ページは固定の秒単価を保証しないと述べています。ToAPIs 料金ページの公式ベンダー参考行は表示用であり、口座の請求と一致するとは限りません。
    • 見積もりはチャネル保証ではありません。 1.5 のリファレンスは、見積もり成功が生成チャネルの利用可能性を意味しないと注記しています。
    • プロンプト層で支出を制御する: まず 720p と 8 秒前後の中尺で試し、バージョン管理したテンプレートを使い、一度に 1 変数だけ変え、クライアントタイムアウト後は状態を確認してから再投入します。
    • 公式ベンダー契約には年間コミット、席数、前払い下限が付くことがあります。ToAPIs の課金は通常従量課金です。アカウント上の現行条件を確認してください。

    6. よくある質問

    frontmatter の FAQ を参照してください。要約: grok-video-3 は現行の公開カタログ ID ではありません。grok-video-1.5 または grok-video-1.0 から始め、1.0 の尺上限はチャネル固有の確認事項として扱い、同期音声は文書化されておらず、必ず generations のステータスパスをポーリングし、タスク id を保存してください。


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

    • ToAPIs 開発者ポータル でキーを作成する。
    • GET /v1/models?type=video で、キーから grok-video-1.5 または grok-video-1.0 が見えることを確認する。一覧と API リファレンスの両方に後から現れない限り、grok-video-3 は送らない。
    • video_generation_mode: "text_to_video"、duration: 8、resolution: "720p" で上記の cURL をスモークテストする。
    • 期限を設けて GET /v1/videos/generations/{id} をポーリングし、expires_at の前に結果をダウンロードする。
    • 次のステップ: 既存クライアントを ToAPIs に向ける場合は OpenAI 互換アクセスガイド、現行カタログは Grok Video 1.5 モデルガイド。1.0 で 6 秒を超える尺に依存する前に Grok Video 1.0 モデルガイド を確認する。

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

    xAIVIDEO

    grok-video-1.0

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

    Grok Video 1.5

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

    関連記事

    tutorial2026-11-17T10:00:00+08:007 分で読める

    OpenAI 互換エンドポイントで Grok Video 3 API にアクセスする

    OpenAI 互換クライアントを ToAPIs に向け、現行の Grok Video カタログ ID を呼び出します。Bearer 認証と /v1 オリジンは共有し、動画ジョブは未公開の grok-video-3 パスではなく POST /v1/videos/generations を使います。

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

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

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

    TO
    ToAPIs Engineering & Evaluation Team
    #Wan 3.0
    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
    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.