Grok API：キー、エンドポイント、モデル、最初のリクエスト

Grok APIとは

Grok APIは、SpaceXSI（旧xAI）の有料の開発者向けインターフェースです。Grokアプリを支えるのと同じGrokモデルファミリーに加え、画像・動画・音声モデルにも、自分のコードからアクセスできます。料金はトークン単位、画像単位、動画の秒単位、音声の分単位で支払います。

APIは一般消費者向けのプランとは別物です。The X Subscriptionの料金ページではPlusの項目に「Grok API access」と書かれていますが、API利用は別途請求されるとも記載されています。SpaceXSIは両者の関係を説明していないため、API呼び出しはコンソールのクレジットで支払う前提で計画しましょう。

主な用途は一般的なものです。自分のアプリでのチャットと推論、ツールを呼び出すエージェント、文書や画像の理解、メディア生成などです。わかりやすい定義は用語集のAPIの項目をご覧ください。

Grok APIキーの取得方法

SpaceXSIのクイックスタートでは、4つのステップが説明されています。

1. console.x.aiでアカウントを作成します。
2. 前払いクレジットをチャージします。ドキュメントによると、呼び出しを使うにはクレジットが必要です。
3. API Keysページを開いてキーを生成します。
4. キーはソースコードではなく、XAI_API_KEYという名前の環境変数に保存します。

請求はデフォルトで前払い制です。クレジットがなくなると、リクエストは拒否されます。自動チャージをオンにすることもでき、最低額は$5です。請求書払いはデフォルトでオフで、SpaceXSIの営業に申し込む必要があります。

ベースURL、SDK、エンドポイント

すべてのリクエストはベースURL https://api.x.ai/v1 に送ります。ドキュメントでは3つの呼び出し方法が挙げられています。

• xai_sdk：公式のPython SDK。
• OpenAI SDK（PythonとJavaScript）：xAIのベースURLを指定して使います。
• Vercel AI SDK：@ai-sdk/xaiパッケージ経由で使います。

Responses APIかChat Completionsか

/v1/responsesのResponses APIがSpaceXSIのメインのインターフェースです。/v1/chat/completionsのChat Completionsも引き続きサポートされています。Grok 4.7では、Responses APIの呼び出しは常に暗号化された推論を返します。旧来の/v1/completionsエンドポイントは/v1/chat/completionsに置き換えられています。

Anthropic形式のエンドポイントは非推奨

Anthropic互換の/v1/messagesと/v1/completeエンドポイントは非推奨とされています。SpaceXSIは代わりにResponses APIかgRPCを使うよう案内しています。廃止日は示されていませんが、新しいプロジェクトではこれらを前提に構築すべきではありません。

米国リージョンのエンドポイント

米国のエンドポイントhttps://us.api.x.ai/v1では、推論処理が米国内で行われます。料金はグローバル料金の1.1倍で、grok-4.7とgrok-4.6のみに対応しています。詳細はGrok APIの料金ページにあります。

最小限の最初のリクエスト

この例では、curlでResponses APIを呼び出します。キーがXAI_API_KEYに保存されていることを前提としています。

curl https://api.x.ai/v1/responses -H "Authorization: Bearer $XAI_API_KEY" -H "Content-Type: application/json" -d '{"model": "grok-4.7", "input": "Explain a context window in one sentence."}'

初日から知っておきたい設定が2つあります。

• reasoning_effort：Grok 4.7では、low、medium、high（デフォルト）、xhighを指定できます。
• prompt_cache_key（またはx-grok-conv-idヘッダー）：SpaceXSIは設定を強く推奨しています。設定しないと、キャッシュのないサーバーにリクエストが届き、入力料金を満額支払うことになる場合があります。

フィールド名は変わることがあります。本番投入の前に、公式ドキュメントのリクエストリファレンスを確認してください。

Grok APIのモデル

現在のテキストモデルと、100万トークンあたりの米ドル料金です。20万トークンを超えるプロンプトは料金が2倍になります。

Grok 4.7 Fastは公開APIでは提供されておらず、CursorとGrok Buildでのみ提供されています。grok-3、grok-4-0709、Grok 4 Fast、grok-code-fast-1を含むいくつかの旧モデルは、2026年5月15日に廃止されました。grok-code-fast-1への呼び出しは、現在grok-build-0.1に転送されます。

APIでは、Grok Imagineの画像・動画モデルとGrok Voiceのモデルも提供されています。Grok ImagineとGrok Voice APIガイドをご覧ください。

内蔵ツール

Grokモデルは、SpaceXSIが運用するサーバー側のツールを呼び出せます。料金ページに掲載されているのは次のツールです。

• Web SearchとImage Search。
• X Search：Xの投稿やプロフィールを返します。
• Code Execution。
• File attachment searchとCollections Search：自分の文書を対象にした検索です。
• view_image、view_x_video、Remote MCPツール：トークン料金のみがかかります。

ほとんどのツールは、トークン料金に加えて1,000回の呼び出しごとに課金されます。モデルごとにティア別のリクエスト数とトークン数の上限もあり、Grok APIのレート制限のページで解説しています。

よくある質問