結論
Grok API は、Grok のモデル(2026年11月18日時点の主力は grok-4.7)をプログラムから呼ぶための有料の API です。console.x.ai でクレジットを入れて API キーを作り、環境変数 XAI_API_KEY に置いて、OpenAI SDK の base_url を https://api.x.ai/v1 に変えれば Python から呼べます。
この記事でわかること
- モデル一覧・料金表(20万トークンを境に単価が倍)と月の費用の試算
- OpenAI SDK・xai_sdk が実際に送るリクエストの形(模擬サーバーで取得)
- 401・404・429 などのエラーと、SDK の再試行の動き
この記事で実際に動かしたもの:127.0.0.1 の模擬サーバー(HTTP と gRPC)に、OpenAI SDK・xai_sdk・curl から Grok API と同じ形のリクエストを送り、送信の中身・ストリーミング・エラー・再試行を確かめました。料金の試算も Python で計算しています。
flowchart TD
A[自分のプログラム] --> B{どの SDK?}
B -->|OpenAI SDK| C[HTTPS<br>api.x.ai/v1/responses]
B -->|xai_sdk| D[gRPC<br>api.x.ai]
C --> G[grok-4.7 など]
D --> G
よく調べられることの答えを先にまとめます。
| 知りたいこと | 答え | 詳しい節 |
|---|---|---|
| Grok API とは | Grok のモデルを自分のアプリから呼ぶ API。トークン単位の従量課金 | Grok API とは |
| Grok API の料金 | grok-4.7 は入力 $2.00・出力 $6.00(100万トークンあたり、20万未満) | Grok API の料金 |
| Grok API は無料か | 料金・請求のページに無料のクレジットの記載は無かった。前払いのクレジットから引かれる | Grok API の料金 |
| Grok API キーの取り方 | console.x.ai に登録→クレジットを入れる→API Keys のページで作る | Grok API キーの取り方 |
| Python での呼び出し | OpenAI SDK の base_url を変える。または xai_sdk を使う | Python での呼び出し |
| 429 が出た | レート制限。待ってから再試行。上限は累計の支払額で上がる | エラーとレート制限 |
| X API との違い | X API は X の投稿やアカウントを扱う API。Grok API は AI のモデルを呼ぶ API | X API・Groq との違い |
確認環境:Ubuntu 24.04.5 LTS の Python 3.13.18 に venv を作り、openai(Python SDK)3.55.0 と xai-sdk 1.21.0(grpcio 1.85.3)を入れました。公式ドキュメントの応答の形をまねた HTTP の模擬サーバーと、xai_sdk に同梱の gRPC の定義で作った模擬サーバーを 127.0.0.1 に立て、SDK と curl 8.5.0 から送って、送信の中身・例外・再試行を確かめました。本物の Grok API には接続しておらず、ログイン・API キーの作成・課金もしていません(キーは架空の文字列、環境は env -i で外の設定を外しています)。モデルの返す文章とエラーの文面は模擬サーバーの自作です。モデル名・料金・上限・エラー・データの扱いは公式ドキュメント(docs.x.ai)の記載です。図は mermaid 11.16.0 で描画を確かめています(確認日 2026年11月18日)。
本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。
(記載例)出典:株式会社RJC「Grok APIの使い方|xAIのAPIキー・料金・Pythonでの呼び出し」
Grok API とは(できること・提供元の名前)
この節では、Grok API で何ができるのかと、公式ドキュメントでの提供元の呼び方が分かります。
Grok API は、対話 AI「Grok」と同じ系統のモデルを、自分のプログラムや業務システムから呼び出すための API です。 文章の生成のほか、画像の理解、画像・動画の生成、音声(読み上げ・文字起こし・音声での対話)、Web 検索や X の検索を組み合わせたツール呼び出しまで、公式ドキュメントに機能が並んでいます。
- 提供元の表記:Grok は xAI が開発した AI として知られていますが、2026年11月18日時点の公式ドキュメントのサイト名は「SpaceXSI Docs」で、クイックスタートは「SpaceXSI API」を Grok のモデルの公式の API と説明しています。一方で、ドメイン(x.ai・api.x.ai・console.x.ai)、SDK の名前(xai_sdk)、環境変数(XAI_API_KEY)は x.ai・xai のままです。
- 呼び出し口:基本の URL は
https://api.x.ai/v1です。文章の生成は Responses API(/v1/responses)が中心で、Chat Completions(/v1/chat/completions)は公式に「legacy(以前からの)エンドポイント」と書かれています。 - SDK:クイックスタートでは xAI SDK(
pip install xai-sdk)、OpenAI SDK(pip install openai・npm install openai)、Vercel AI SDK(@ai-sdk/xai)が案内されています。
Grok API と X API・Grok(アプリ)・Groq の違い
この節では、名前が似ているサービスとの違いが分かります。
Grok API は「AI のモデルを呼ぶ API」で、X の投稿やアカウントを扱う X API とは目的が別です。 grok.com や X の中で使う Grok(アプリ)とも、契約と料金の仕組みが分かれています。
| 名前 | 何をするものか | 料金の考え方 |
|---|---|---|
| Grok API | Grok のモデルをプログラムから呼ぶ | トークン・回数の従量課金(前払いのクレジット) |
| Grok(grok.com・アプリ) | 人が画面で Grok と対話する | アプリ・X の購読の料金(API とは別) |
| X API | X の投稿・ユーザー・検索をプログラムで扱う | X の開発者向けの料金 |
| Groq | 別の会社の AI 推論サービス(名前が似ているだけ) | Groq の料金 |
Grok API の X Search を使うと、X の投稿を検索した結果をもとにモデルが答えます。X に投稿する・X のデータを直接取得する用途は X API の役割です(記事「X API(旧Twitter API)の使い方|料金・キーの取得・Pythonで投稿」の題材です)。名前の似た Groq については、記事「Groqとは|LPUで速いAI推論・使い方・料金とAPIの呼び出し方」にまとめています。
Grok API のモデル一覧(2026年11月18日時点)
この節では、Grok API で指定できるモデル名と、それぞれの文脈の長さが分かります。
文章のモデルは、公式の料金ページに次の8つが並んでいました。 公式のモデルのページは grok-4.7 を「コードとそれ以外のすべてに向けた主力(flagship)」と説明しています。
| モデル名(model に書く値) | 文脈の長さ | メモ(公式の記載) |
|---|---|---|
grok-4.7 | 500k | 主力。2026年9月21日に提供開始。知識の区切りは2026年5月 |
grok-4.6 | 500k | 2026年8月12日に提供開始 |
grok-4.5 | 500k | 2026年7月8日に提供開始 |
grok-4.3 | 1M | 5月15日に退役したモデルの転送先 |
grok-4.20-0309-reasoning | 1M | 推論あり |
grok-4.20-0309-non-reasoning | 1M | 推論なし |
grok-4.20-multi-agent-0309 | 1M | 複数のエージェントで答える |
grok-build-0.1 | 256k | コーディング向け(Grok Build) |
- 別名の決まり:公式は「
<モデル名>は最新の安定版、<モデル名>-latestは最新版、<モデル名>-<日付>は特定のリリース」を指すと説明しています。挙動を固定したいときは日付つきの名前を使います。 - 画像・動画・音声:
grok-imagine-image-2.0・grok-imagine-video-1.5・Grok Voice(2026年10月14日からgrok-voice-latestは grok-voice-3.0 を指す)です。
退役したモデル名と移行先
以前の記事に出てくる grok-3 や grok-4-0709 は、2026年5月15日に退役しました。公式の移行ガイドによると、以前の名前のままでもリクエストは転送先で処理されますが、転送先の単価で課金されます。
| 退役したモデル | 5月15日以降の転送先 |
|---|---|
grok-4-1-fast-reasoning・grok-4-fast-reasoning・grok-4-0709 | grok-4.3(推論の深さ low) |
grok-4-1-fast-non-reasoning・grok-4-fast-non-reasoning・grok-3 | grok-4.3(推論の深さ none) |
grok-code-fast-1 | grok-build-0.1 |
移行ガイドは、model を書き換え、推論の深さ(none〜high)を自分で指定することを勧めています。
Grok API の料金(公式の料金表)
この節では、Grok API の料金表と、ツール・Batch・地域ごとの追加の決まりが分かります。
文章のモデルは、入力・キャッシュされた入力・出力のトークン数で課金されます。 プロンプトが20万トークン(200k)を超えるリクエストは、そのリクエストの全トークンが長文の単価になります(公式:長文の単価のあるモデルは、リクエストのすべてのトークンを長文の単価で請求)。
| モデル | 入力 | キャッシュ入力 | 出力 | 20万超の入力/出力 |
|---|---|---|---|---|
| grok-4.7・grok-4.6 | $2.00 | $0.50 | $6.00 | $4.00/$12.00 |
| grok-4.5 | $2.00 | $0.30 | $6.00 | $4.00/$12.00 |
| grok-4.3・grok-4.20 系 | $1.25 | $0.20 | $2.50 | $2.50/$5.00 |
| grok-build-0.1 | $1.00 | $0.20 | $2.00 | $2.00/$4.00 |
単位は100万トークンあたりの米ドルです(2026年11月18日時点の公式の料金ページ。ページの最終更新は2026年10月10日)。
| 追加の料金・割引 | 公式の記載 |
|---|---|
| Web Search・Code Execution | 1,000回あたり $5(トークンの料金は別) |
| X Search | 取得した投稿1,000件あたり $5、プロフィール1,000件あたり $10 |
| Batch API | grok-4.7・4.6・4.5・4.3・4.20 系は20%引き |
| 優先処理(Priority Processing) | 通常の2倍。応答に "service_tier": "priority" が付いたときだけ |
| US の地域のエンドポイント | 通常の1.1倍(grok-4.7・grok-4.6 だけ) |
| 画像の生成 | grok-imagine-image-2.0 は 1K Low で1枚 $0.04 から |
| 利用のガイドラインで生成前に止められたリクエスト | 1件 $0.05(Responses API) |
無料で使えるか・支払いの仕組み
公式の料金と請求(Billing)のページには、無料のクレジットの記載は見つかりませんでした。 請求のページにあったのは次の内容です。
- チーム単位でクレジットを前払いし、API の使用分がそこから引かれる。前払いのクレジットが無くなると、API のリクエストは自動で断られる。
- 残高が決めた額を下回ったら自動で買い足す設定(Auto top-up、最低 $5)がある。
- 請求書払い(invoiced billing)は既定で無効で、上限は $0。営業窓口への申し込みが要る。
Grok API の料金の計算(手元で計算した試算)
この節では、公式の単価から1回・1か月の費用を計算した結果と、20万トークンの境目で費用がどう変わるかが分かります。
1回あたり入力2,000・出力500トークンを grok-4.7 で1万回送ると、月 $70 になりました。 上の料金表の単価を Python の関数(20万超の切り替え・キャッシュ・Batch・優先処理・US の倍率を入れたもの)に入れて計算しました。
| 条件 | 費用(米ドル) |
|---|---|
| grok-4.7・1回(入力2,000・出力500) | $0.0070 |
| grok-4.7・1万回/月 | $70.00 |
| 1万回/月・入力のうち1,500がキャッシュに当たる | $47.50 |
| 1万回/月・Batch API(20%引き) | $56.00 |
| 1万回/月・US のエンドポイント(1.1倍) | $77.00 |
| 1万回/月・優先処理(2倍) | $140.00 |
| 1万回/月・Web 検索を毎回3回(ツールの分だけ) | $150.00 |
長い文書を丸ごと渡すときは、20万トークンの境目に注意が要ります。 入力199,000・出力1,000なら1回 $0.404 ですが、入力201,000では全トークンが長文の単価になり $0.816 と約2倍でした。検索ツールの料金はトークンとは別に回数でかかるため、検索を多用するとツールの分がトークンの分を上回ります。日本語の文章が何トークンになるかの目安は、関連記事「トークンとは|生成AIの数え方・日本語の文字数目安と節約方法」で扱っています。
Grok API キーの取り方(画面の流れ)
この節では、API キーを作るまでの流れと、キーの扱いで気をつける点が分かります。
公式のクイックスタートの流れは、登録→クレジット→キーの作成→環境変数の4段階です。 この記事ではログインしていないため、画面の名前はクイックスタートの記載にある語だけを書いています。
console.x.ai に登録する
公式のコンソール(console.x.ai)でアカウントを作ります。チームの単位で請求とキーを管理します。
クレジットを入れる
前払いのクレジットを入れます。残高が無いとリクエストは断られます。自動の買い足し(最低 $5)も選べます。
API Keys のページでキーを作る
作った直後にキーを控えます。Management API の説明では、作成後はキーの全体を表示せず、キーごとに使えるモデル・エンドポイント(ACL)や上限(qpm・tpm)、有効期限を持てます。
環境変数に置く
export XAI_API_KEY="..." か、プロジェクトの .env に XAI_API_KEY=... と書きます。コードに直接書かないようにします。
Python での呼び出し(OpenAI SDK・Responses API)
この節では、OpenAI SDK で Grok API を呼ぶコードと、SDK が実際に送る中身が分かります。
OpenAI SDK は、api_key と base_url を変えるだけで Grok API に向けられます。 公式のクイックスタートと同じ形で、Responses API を呼ぶコードです。
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["XAI_API_KEY"],
base_url=os.environ.get("XAI_BASE_URL", "https://api.x.ai/v1"),
)
response = client.responses.create(
model="grok-4.7",
input=[{"role": "user", "content": "Grok API の要点を1文で"}],
max_output_tokens=200,
)
print(response.output_text)
print(response.usage)
手元では XAI_BASE_URL=http://127.0.0.1:18655/v1 にして模擬サーバーへ送りました。出力と、模擬サーバーが受け取った中身です(キーは途中で切っています)。
$ python3 c1_openai_responses.py
(模擬サーバーの固定の応答)
ResponseUsage(input_tokens=12, input_tokens_details=None, output_tokens=9, output_tokens_details=None, total_tokens=21)
[模擬サーバーの記録]
POST /v1/responses
authorization: Bearer xai-dum...(略)
content-type: application/json
user-agent: OpenAI/Python 3.55.0
x-stainless-retry-count: 0
body: {"model":"grok-4.7","input":[{"role":"user","content":"Grok API の要点を1文で"}],"max_output_tokens":200}
SDK が送るのは Authorization: Bearer キー と JSON の本文だけで、公式の curl の例と同じ形です。
curl https://api.x.ai/v1/responses \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "grok-4.7", "input": "Grok API の要点を1文で"}'
Responses API と Chat Completions の違い
Responses API(/v1/responses)
本文は input、上限は max_output_tokens
previous_response_id で前の会話を続けられる
応答はサーバーに30日保存(store の既定は true)
Chat Completions(/v1/chat/completions)
本文は messages、上限は max_tokens
状態を持たない。履歴を毎回送り直す
公式は legacy と説明。新機能は Responses API が先
OpenAI SDK の書き方そのものは、関連記事「OpenAI API Python入門|Responses APIのコピペ集」で詳しく扱っています。同じ OpenAI 互換の形をとる DeepSeek の API は、記事「DeepSeek APIの使い方|料金・APIキー・OpenAI互換のPython例」の題材です。
xAI SDK(xai_sdk)での呼び出し
この節では、公式の xAI SDK の書き方と、OpenAI SDK との送り方の違いが分かります。
xai_sdk は HTTP ではなく gRPC で api.x.ai に送ります。 会話を chat.create() で作り、append() で発言を足して、sample()(まとめて受け取る)か stream()(少しずつ受け取る)を呼ぶ形です。
import os
from xai_sdk import Client
from xai_sdk.chat import user, system
client = Client(api_key=os.environ["XAI_API_KEY"]) # 既定の接続先は api.x.ai
chat = client.chat.create(model="grok-4.7", max_tokens=200)
chat.append(system("短く答える"))
chat.append(user("Grok API の要点を1文で"))
r = chat.sample()
print(r.content, r.usage.prompt_tokens, r.usage.completion_tokens)
chat2 = client.chat.create(model="grok-4.7")
chat2.append(user("こんにちは"))
for response, chunk in chat2.stream():
print(chunk.content, end="", flush=True)
手元では Client(api_host="127.0.0.1:18656", use_insecure_channel=True) にして、xai_sdk に同梱の定義で作った gRPC の模擬サーバーに送りました。
sample: (gRPC 模擬の応答) | usage: 15 8
gRPC|の|ストリーム|
[模擬サーバーの記録]
rpc: GetCompletion
metadata: user-agent: XaiSdk/1.21.0 grpc-python/1.85.3 ...
authorization: Bearer xai-dum...(略)
xai-sdk-version: python/1.21.0
request: {"messages": [{"content": [{"text": "短く答える"}], "role": "ROLE_SYSTEM"},
{"content": [{"text": "Grok API の要点を1文で"}], "role": "ROLE_USER"}],
"model": "grok-4.7", "maxTokens": 200, "n": 1}
rpc: GetCompletionChunk (stream() のとき)
- キーが無いときの原文:
ValueError: Trying to read the xAI API key from the XAI_API_KEY environment variable but it doesn't exist. - xai_sdk には OpenTelemetry のトレースの仕組みがあり、
XAI_SDK_DISABLE_TRACING=1で止められます(SDK のソースで確かめました)。
SDK の選び方
迷ったら:既存のコードがあるなら OpenAI SDK、新しく作るなら公式の xai_sdk
Grok API のストリーミングの使い方
この節では、応答を少しずつ受け取る書き方と、流れてくるデータの形が分かります。
ストリーミングは、リクエストに "stream": true を付けると、Server-Sent Events(SSE)で差分が届き、最後に data: [DONE] が来ます。 OpenAI SDK での書き方です。公式の例は、推論するモデルで接続が途中で切れないよう、タイムアウトを3600秒と長めにしています。
client = OpenAI(api_key=os.environ["XAI_API_KEY"],
base_url="https://api.x.ai/v1", timeout=3600)
stream = client.chat.completions.create(
model="grok-4.7",
messages=[{"role": "user", "content": "こんにちは"}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
模擬サーバーに curl で送ったときの生のデータです(公式の例と同じ chat.completion.chunk の形をまねています)。
$ curl -N .../v1/chat/completions(stream: true を付けて送る)
data: {"id": "chat_mock_1", "object": "chat.completion.chunk", "created": 0, "model": "grok-4.7", "choices": [{"index": 0, "delta": {"content": "模擬", "role": "assistant"}}]}
(「の」「ストリーム」の2行が同じ形で続く)
data: [DONE]
SDK 経由では 模擬|の|ストリーム| の3回に分かれて届きました。画像を出力するモデルではストリーミングは使えません(公式)。
Grok API のエラーとレート制限(429の再試行)
この節では、HTTP ステータスごとの意味と直し方、レート制限の決まり、再試行の書き方が分かります。
公式のエラーのページは、ステータスごとの意味を次のように説明しています。 下の「手元」の欄は、模擬サーバーで同じ状況を作って SDK・curl で受けた結果です。
| ステータス | 公式の説明 | 直し方 | 手元(OpenAI SDK の例外など) |
|---|---|---|---|
| 400 | 本文の値の誤り・URL のパラメーターの誤り・正しくない API キー | 本文と URL を見直す | ― |
| 401 | Authorization ヘッダーが無い・トークンが無効 | Authorization: Bearer <XAI_API_KEY> を付ける | curl で HTTP 401 |
| 403 | キーやチームに権限が無い・止められている | チームの管理者に権限を頼む | ― |
| 404 | モデル名が無い・URL の綴りの誤り | モデル名と URL を API リファレンスで確かめる | NotFoundError Error code: 404 |
| 405 | HTTP のメソッドの誤り | GET と POST を確かめる | curl の GET で HTTP 405 |
| 415 | 本文が空・JSON の Content-Type が無い | Content-Type: application/json を付ける | curl で HTTP 415 |
| 422 | 本文の項目の形式の誤り | 本文を API リファレンスで確かめる | ― |
| 429 | リクエストが多すぎる | 頻度を下げる・上限を上げる | RateLimitError(xai_sdk は RESOURCE_EXHAUSTED) |
レート制限の決まり
- 上限はモデルごとに、1秒あたりのリクエスト数(RPS)と1分あたりのトークン数(TPM)の2つです。RPS は1分あたりのリクエスト数(RPM)を48で割った値(最低2)です。たとえば RPM 480 なら RPS 10 になります。
- 階層(Tier)は2026年1月1日からの累計の支払額で決まり、下がることはありません。
- 自分の階層とモデルごとの上限は、コンソールの Models のページで見られます。
- 0Tier 0:$0(既定)登録した直後
- 1Tier 1:累計 $50 から支払いが増えると自動で上がる
- 2Tier 2:累計 $250 から―
- 3Tier 3:累計 $1,000 から―
- 4Tier 4:累計 $5,000 からさらに上は Enterprise(申し込み)
429 の再試行(手元で動かした結果)
OpenAI SDK は、429 を受けると既定で2回まで自動で再試行しました。 模擬サーバーが2回続けて429(retry-after: 1)を返すようにして送ると、3回目で成功し、経過は2.04秒でした。記録には再試行の回数が x-stainless-retry-count として残ります。
結果: (模擬の応答) 経過 2.04 秒
[模擬サーバーの記録] 経過(秒) x-stainless-retry-count
0.0 0
1.0 1
2.01 2
自分で回数と待ち時間を決めたいときは、OpenAI(..., max_retries=0) にして RateLimitError を受け、待ち時間を倍にしながら再試行します(公式の例は最大5回、2 ** attempt 秒待つ形。1・2・4・8・16秒で合計31秒)。
手元で待ち時間を短くして動かすと、2回の429のあと3回目で200になりました。429 の考え方は、関連記事「LLM APIの429・529エラー対処|リトライ実装とエラー一覧」で詳しく扱っています。障害が疑われるときは公式の状態のページ(status.x.ai)を見ます。
Grok API のデータの扱いと地域(提供元の説明)
この節では、送った内容の保存期間や学習への利用について、提供元が何と説明しているかが分かります。
公式の「Data & Privacy」のページは、明示の許可なく API の入力・出力を学習に使わないと説明しています。 以下は提供元の説明の紹介で、RJC が内容を保証するものではありません。機密情報・個人情報を送る前に、提供元の最新の規約と所属先の決まりを確かめます。
- 保存:既定では、API のリクエストと応答は監査のために30日間サーバーに暗号化して保存され、30日後に自動で消える。
- ZDR(Zero Data Retention):有効にすると入力と出力をディスクに残さない。チーム全体の設定で、公式は多くの利用者には勧めないとしている。
- 処理の地域:既定のエンドポイント(api.x.ai)は処理の地域を保証しない。US のエンドポイント(
https://us.api.x.ai/v1)は、リクエストの処理・推論・保存を米国内にとどめる。ただし使えるのは grok-4.7・grok-4.6 だけで、ファイル・コレクション・サーバー側のツールは保証の外。
US のエンドポイントへの切り替えは、OpenAI SDK なら base_url="https://us.api.x.ai/v1"、xai_sdk なら api_host="us.api.x.ai"(https:// と /v1 を付けない)です。公式は、既存の API キーがどちらでも使えると書いています。
- 1キーは環境変数か秘密の管理の仕組みに置くコード・リポジトリ・ログに残さない。漏れたらコンソールで無効化か再発行
- 2キーごとに使えるモデルと上限を絞るACL と qpm・tpm で、1本のキーの使いすぎを止める
- 3送るデータの種類を先に決める保存の30日・ZDR・地域の説明を読み、所属先の決まりと合わせる
- 4自動の買い足しに月の上限を付けるAuto top-up は月の最大額を設定できる
よくあるエラー/つまずき
この節では、Grok API を使い始めたときにつまずきやすい点と、その直し方が分かります。
| 症状・原文 | 原因 | 直し方 |
|---|---|---|
Missing credentials. Please pass an `api_key`...(OpenAI SDK) | api_key を渡していない。OpenAI SDK は XAI_API_KEY を自動では読まない | api_key=os.environ["XAI_API_KEY"] を渡す |
Trying to read the xAI API key from the XAI_API_KEY environment variable but it doesn't exist. | xai_sdk が環境変数を見つけられない | 同じシェル・同じ実行環境で XAI_API_KEY を設定する |
| 401 | ヘッダーが無い・キーの誤り | Bearer の形と、キーの前後の空白を確かめる |
| 404(モデル名) | grok-4-7 のような綴りの誤り | モデル名は grok-4.7(点で区切る) |
| 以前の記事のコードで費用が増えた | grok-3 などは grok-4.3 に転送され、その単価で課金 | model を書き換え、推論の深さを指定する |
| リクエストが急に通らなくなった | 前払いのクレジットが無くなった | 残高を確かめ、必要なら Auto top-up を設定する |
| 429 が続く | RPS か TPM の上限。推論のトークンも数えられる | 待って再試行。Batch API にまとめる。階層を上げる |
| 費用が予想の約2倍 | プロンプトが20万トークンを超え、全トークンが長文の単価 | 入力を分けるか、文脈を減らす |
Grok API を使うかの判断表
この節では、やりたいことごとに、Grok API のどの機能・どのモデルを選ぶかが分かります。
| やりたいこと | 選ぶもの | 理由(公式の記載) |
|---|---|---|
| まず1回動かしたい | grok-4.7 + OpenAI SDK(Responses API) | クイックスタートの例と同じ形 |
| 費用を下げたい・大量に流す | grok-4.3 や grok-4.20 系、Batch API | 単価が低い。Batch は20%引き |
| X の最新の話題をもとに答えさせたい | Responses API + x_search | 投稿・プロフィールの件数で別料金 |
| X に投稿したい・X のデータを集めたい | X API | Grok API の役割ではない |
| 処理を米国内にとどめたい | US のエンドポイント | grok-4.7・4.6 だけ。1.1倍 |
| 既存の OpenAI 向けのコードを使い回したい | OpenAI SDK の base_url を変える | 公式が OpenAI SDK の例を載せている |
関数を呼ばせる(Function Calling)仕組みは各社でほぼ共通です。考え方と実装は、関連記事「Function Calling(tool use)の仕組みとPython実装」で扱っています。ほかの提供元の API と並べて比べたいときは、関連記事「Claude API Python入門|Anthropic SDKコピペレシピ集」も同じ観点で読めます。
よくある質問
この節では、Grok API についてよく調べられる疑問への答えが分かります。
Q. Grok API は無料で使えますか?
トークン単位の従量課金で、前払いのクレジットから引かれます。2026年11月18日時点の公式の料金・請求のページには、無料のクレジットの記載は見つかりませんでした(プロモーションコードの入力欄の説明はあります)。
Q. X Premium(X の有料プラン)に入っていれば Grok API も使えますか?
公式のドキュメントでは、API はコンソール(console.x.ai)のチームにクレジットを入れて使い、その残高から引かれる仕組みとして説明されています。X の購読との関係は、公式ドキュメントの「X Subscription」の節で最新の説明を確かめるのが確実です。
Q. OpenAI のライブラリで Grok API を使えますか?
使えます。公式のクイックスタートに、OpenAI SDK の base_url を https://api.x.ai/v1 にする例があります。手元でも、送られる中身は Bearer のキーと JSON の本文だけでした。
Q. grok-3 や grok-4-0709 はまだ使えますか?
2026年5月15日に退役し、リクエストは grok-4.3 などに転送されます。転送先の単価で課金されるため、公式は model の書き換えを勧めています。
Q. 送った内容は学習に使われますか?
提供元は、明示の許可なく API の入力・出力を学習に使わない、既定では30日保存して自動で消す、と説明しています。送る前に最新の規約と所属先の決まりを確かめます。
Q. 429 Too Many Requests が出たら?
少し待ってから再試行します。OpenAI SDK は既定で2回まで自動で再試行しました。上限は累計の支払額で決まる階層で上がり、コンソールの Models のページで確かめられます。
Q. Chat Completions はもう使えないのですか?
公式では legacy のエンドポイントとして載っており、終了日は書かれていませんでした。新機能は Responses API に先に入ります。
Q. xai_sdk と OpenAI SDK のどちらを使うべきですか?
既存の OpenAI 向けのコードがあるなら OpenAI SDK、Grok の機能を型つきで使いたいなら公式の xai_sdk です。xai_sdk は gRPC で送るため、HTTP のプロキシしか通らない環境では OpenAI SDK が通しやすいことがあります。
まとめ
この節では、記事の要点を5つにまとめます。
- Grok API は Grok のモデルをプログラムから呼ぶ有料の API。公式ドキュメントの提供元の表記は2026年11月18日時点で「SpaceXSI」、ドメインと SDK は x.ai・xai のまま。
- 主力は grok-4.7(入力 $2.00・出力 $6.00、100万トークンあたり)。20万トークンを超えると全トークンが倍の単価。
- キーは console.x.ai でクレジットを入れてから作り、
XAI_API_KEYに置く。残高が無いとリクエストは断られる。 - OpenAI SDK は base_url を変えるだけで呼べ、送る中身は Bearer のキーと JSON。xai_sdk は gRPC で送る。
- 429 は待って再試行。データの扱い・地域は提供元の説明を読み、送るデータの種類を先に決める。
参考・出典
この節では、記事で確かめた公式の情報源が分かります(確認日 2026年11月18日)。
- SpaceXSI Docs「Quickstart」:https://docs.x.ai/developers/quickstart
- SpaceXSI Docs「Models」:https://docs.x.ai/developers/models
- SpaceXSI Docs「Pricing」:https://docs.x.ai/developers/pricing
- SpaceXSI Docs「Release Notes」:https://docs.x.ai/developers/release-notes
- SpaceXSI Docs「Model Retirement (May 15, 2026)」:https://docs.x.ai/developers/migration/may-15-retirement
- SpaceXSI Docs「Rate Limits」:https://docs.x.ai/developers/rate-limits
- SpaceXSI Docs「Debugging Errors」:https://docs.x.ai/developers/debugging
- SpaceXSI Docs「Streaming」:https://docs.x.ai/developers/model-capabilities/text/streaming
- SpaceXSI Docs「X Search」:https://docs.x.ai/developers/tools/x-search
- SpaceXSI Docs「Regional Endpoints」:https://docs.x.ai/developers/advanced-api-usage/regions
- SpaceXSI Docs「Data & Privacy」:https://docs.x.ai/developers/faq/security
- SpaceXSI Docs「Manage Billing」:https://docs.x.ai/console/billing
- SpaceXSI Docs「Accounts and Authorization(Management API)」:https://docs.x.ai/developers/rest-api-reference/management/auth
本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。
(記載例)出典:株式会社RJC「Grok APIの使い方|xAIのAPIキー・料金・Pythonでの呼び出し」
株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。
WE ARE HIRING
RJCで一緒に開発しながら、
成長を楽しみませんか?
RJCは、Web・モバイル・AIを活用した開発プロジェクトで、テックリードやPM・PMOも活躍するシステム開発会社です。会社を知る、待遇を確かめる、話を聞いてみる。気になるところ見てみてください!
- 127日年間休日
- 12時間平均残業時間
- 毎日ガチャ遊びココロも大切にする福利厚生。アマギフなどの賞品ラインナップ!
ほかにも、チケットレストラン、書籍読み放題、2年ごとの慰労報奨(休暇 or 金一封)、11期連続の黒字決算。