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. OpenAI 互換エンドポイントで Grok Video 3 API にアクセスする
    すべての記事に戻る
    tutorial2026-11-177 分で読める

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

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

    ToAPIs Engineering & Evaluation Team
    Grok VideoOpenAI CompatibleVideo APIAPI GatewayTutorial
    TL;DR - 要点まとめ
    • ToAPIs は統一された OpenAI 互換の /v1 オリジンと Bearer API キーを文書化しています。openai-video エンドポイントに現在載っている Grok Video ID は grok-video-1.0 と grok-video-1.5 であり、grok-video-3 ではありません。
    • 動画モデルは GET /v1/models?type=video で列挙します。デフォルトのモデル一覧はテキストモデルのみです。type を省略すると Grok Video ID は見えません。
    • 作成は POST /v1/videos/generations、ポーリングは GET /v1/videos/generations/{id} です。これが文書化された動画契約です。アカウントのドキュメントが示さない限り、ToAPIs に client.videos.create のような OpenAI Videos SDK メソッドがあると仮定しないでください。
    • チャット、アップロード、動画で同じ Authorization ヘッダーを使います。ローカル素材は POST /v1/uploads/images でアップロードし、返却された公開 URL を渡します。
    • 正確なモデル文字列とライブ料金はアカウントで確認してください。互換オリジンだけでは、未公開のモデル ID も固定単価も生まれません。

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

    対象モデル: grok-video-1.5、grok-video-1.0
    推論エンドポイント: https://api.toapis.com/v1/videos/generations
    関連記事: Grok Video 実践ガイド · Grok Imagine 公式チャネル API · Chatbox の OpenAI 互換設定 · モデル一覧


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

    • ここでいう「OpenAI 互換」: ToAPIs は単一の /v1 オリジン、Bearer 認証、OpenAI 風のモデル一覧とチャット補完 API を文書化しています。公開の Grok Video ID はカタログの openai-video エンドポイントファミリーに登録されています。これは未公開の grok-video-3 が使えることでも、OpenAI Videos SDK メソッドが文書化されていることでもありません。
    • ID: GET /v1/models?type=video であなたのキーに見えてから grok-video-1.5 または grok-video-1.0 を使います。2026-11-10 付けの公開カタログスナップショットに grok-video-3 はありません。
    • 動画パス: 作成は POST /v1/videos/generations、ポーリングは GET /v1/videos/generations/{id} です。公式例は https://toapis.com(中国本土は https://toapis.cn)です。本シリーズは https://api.toapis.com も使います。
    • 共有認証: Authorization: Bearer に 1 つの API キーを使います。これらの動画呼び出し向けの公開 OAuth スコープ文書はありません。
    • クライアントの選び方: チャットや使い慣れたキー/オリジン設定には、OpenAI SDK の base_url="https://api.toapis.com/v1" を使えます。Grok Video では、video_generation_mode と画像 URL を明示するため、文書化された REST JSON 本体を使います。

    2. 互換オリジン、モデル一覧、動画パス

    オリジン、/v1 プレフィックス、キーはセットで使います。ToAPIs のキーを https://api.openai.com/v1 に混ぜたり、ToAPIs のオリジンをベンダー固有の Grok パスと組み合わせたりする構成は、別の(しかも未文書化の)セットアップです。

    手順文書化されたパス注記
    モデル一覧GET /v1/models?type=videoデフォルトの GET /v1/models はテキストモデルのみです。type=video または type=all を使います
    ローカル画像のアップロードPOST /v1/uploads/images(multipart file)data.url を読みます。生成リクエストに base64 を送らないでください
    Grok Video ジョブの作成POST /v1/videos/generations本体に model、prompt、1.5 のモード/メディアフィールドを含めます
    ステータスのポーリングGET /v1/videos/generations/{id}終端状態は completed と failed です
    チャット(動画ではない)POST /v1/chat/completionsオリジンとキーだけを共有します

    grok-video-1.5 では、送るメディアに合わせて video_generation_mode を text_to_video、first_frame_image_to_video、または reference_images_to_video にします。フィールド契約の詳細は Grok Video 実践ガイド と Grok Video 1.5 API リファレンス を見てください。

    互換クライアントのパネルが六角形ゲートウェイを経由して投入とポーリングのパスにつながる図

    図 1: クライアントを ToAPIs の /v1 オリジンに向け、モデル一覧で grok-video-1.5 または grok-video-1.0 を確認し、/v1/videos/generations で投入とポーリングを行います。chat/completions は使いません。

    アプリケーションコードではなくデスクトップクライアントを設定する場合は、Chatbox 設定ガイド がチャット用のホスト欄のパターンを扱います。同じチャットパスから動画ファイルが返ることは期待しないでください。


    3. 本番実装: cURL と Python

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

    ステップ 1: ID を確認してから cURL で投入する

    bash
    curl -sS "https://api.toapis.com/v1/models?type=video" \
      -H "Authorization: Bearer $TOAPIS_API_KEY"
    
    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"
      }'
    

    ハードコードする前に、モデル一覧の正確な id 文字列を確認してください。grok-video-3 が無ければ送らないでください。

    ステップ 2: Python — オリジンは共有し、動画は REST で呼ぶ

    ここでの OpenAI SDK は、共有の base_url と API キーのためだけに示します。動画の作成とポーリングは、非公式なクライアントマッピングで 1.5 の本体フィールドが落ちないよう、文書化された generations パスのままにします。

    python
    import os
    import time
    import requests
    from openai import OpenAI
    
    API_KEY = os.environ["TOAPIS_API_KEY"]
    BASE = "https://api.toapis.com"
    HEADERS = {
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json",
    }
    
    # Shared origin and key. Use this client for chat completions; do not assume
    # a videos.create mapping unless your account docs define one.
    client = OpenAI(base_url=f"{BASE}/v1", api_key=API_KEY)
    
    
    def list_video_model_ids() -> list[str]:
        res = requests.get(
            f"{BASE}/v1/models",
            headers=HEADERS,
            params={"type": "video"},
            timeout=30,
        )
        res.raise_for_status()
        data = res.json()
        items = data.get("data") or data.get("models") or []
        return [item.get("id") or item.get("name") for item in items if item]
    
    
    def dispatch_grok_video(prompt: str, model: str = "grok-video-1.5") -> str:
        available = set(list_video_model_ids())
        if available and model not in available:
            raise ValueError(f"{model} is not in this key's video model list")
        res = requests.post(
            f"{BASE}/v1/videos/generations",
            headers=HEADERS,
            json={
                "model": model,
                "prompt": prompt,
                "video_generation_mode": "text_to_video",
                "duration": 8,
                "resolution": "720p",
                "aspect_ratio": "16:9",
            },
            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__":
        print("Video models (excerpt):", list_video_model_ids()[:20])
        task_id = dispatch_grok_video("A cinematic product shot with a slow camera push-in")
        print("Task:", task_id)
        print("Video:", poll_task(task_id))
    

    一覧のエンベロープが想定と違う場合は、生の JSON を記録し、アカウントの モデル一覧 に合わせてパーサを直してください。ID が無いときに grok-video-3 を送るフォールバックを発明しないでください。


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

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

    HTTP またはタスク状態よくある分類推奨アクション
    400未知のモデル ID、モードとメディアの不一致、または動画本体をチャットパスへ送ったGET /v1/models?type=video で ID を確認し、/v1/videos/generations に POST していること、1.5 ジョブに一致する video_generation_mode があることを確認する
    401API キーの欠落または無効OpenAI プラットフォームのキーではなく ToAPIs のキーを使い、Bearer ヘッダーを確認する
    404誤ったオリジン、/v1 の欠落、または /videos/tasks/{id} のような独自パス投入に使った同じオリジンで GET /v1/videos/generations/{id} に切り替える
    429レートまたは同時実行の制限Retry-After があれば従い、ジッター付きでバックオフする
    5xx またはクライアントタイムアウトゲートウェイまたは上流の一時障害再投入の前に既存のタスク id を照会する
    status: failed生成が成功しなかったerror.code と error.message を読む。ポリシーで拒否されたペイロードをそのまま再送しない

    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

    • 互換性は課金 SKU を変えません。 請求対象は送信したカタログ ID(grok-video-1.5 または grok-video-1.0)であり、「OpenAI SDK を使ったこと」ではありません。
    • 企画ドラフトの単価を再利用しないでください。 Grok Video 1.5 のリファレンスは固定の秒単価を保証しません。ToAPIs 料金ページの公式ベンダー参考行は表示用であり、口座の請求と一致するとは限りません。
    • 発見は安く、重複生成は高くつきます。 モデル一覧は短時間キャッシュして構いませんが、クライアントタイムアウト後は、新しいジョブを作る前に必ず状態を確認してください。
    • ToAPIs の課金は通常従量課金です。アカウント上の現行条件を確認してください。

    6. よくある質問

    frontmatter の FAQ を参照してください。要約: 互換オリジンは grok-video-3 を解放しません。/v1 は一度だけ付け、/v1/videos/generations/{id} をポーリングし、SDK の videos.create ヘルパーを仮定せず、チャット補完は MP4 を返しません。


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

    • ToAPIs 開発者ポータル でキーを作成する。
    • クライアントを https://api.toapis.com/v1(中国本土は https://toapis.cn/v1)に向け、Authorization: Bearer を付ける。
    • GET /v1/models?type=video を呼び、キーから見える正確な Grok Video ID を記録する。
    • grok-video-1.5 と video_generation_mode: "text_to_video" で POST /v1/videos/generations をスモークテストし、同じ id をポーリングする。
    • 次のステップ: モードと画像フィールドの詳細は Grok Video 実践ガイド、現行カタログは Grok Video 1.5 モデルガイド。

    記事内で紹介されたモデルと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: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
    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:0010 分で読める

    Kling 3.0 Turbo API:大量ショート動画オートメーションの設計

    ToAPIs 上の kling-3.0-turbo 本番ガイド。文書化された duration と解像度、先頭フレームのみの画像入力、上限付きポーリング、未検証ドラフト単価を使わない高頻度ショート動画の自動化。

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