Grok API キーの作成方法と代替キー

ベンダーによるキーの作成

私たちは独立したサービスであり公式の xAI API ではないため、xAI 自身のキーには xAI 自身のページが必要です。フローはほとんどのプロバイダーに共通ですが、メニュー名は以下と異なる場合があります。

1. アカウントでプロバイダーの開発者コンソールにログインします。
2. 請求セクションを確認してください。キーが機能する前に支払い方法や入金が必要になるプロバイダーもいます。各自の要件を必ずお読みください。
3. API キーセクションを開き、新しいキーの作成を選択します。
4. プロジェクトや環境など、どこで使用するかを示す名前を付けます。
5. キーは直ちにコピーしてください。多くのコンソールでは完全なシークレットは一度だけ表示されます。
6. シークレットマネージャーや環境変数に保存し、ソースコードには決して入れないでください。

ページレイアウトが一致しない場合は、プロバイダーのドキュメントが権威となります。このガイドを含む数ヶ月前に書かれたガイドは、古いインターフェースを記述している可能性があります。

1 分以内でのキー取得

当社のキーは、法的な成人向け利用のためにコンテンツ拒否なしで回答するよう調整された、1つのホスト型オープンウェイトモデルを提供するOpenAI互換エンドポイント用です。取得には5つのステップが必要です。

1. APIキーページを開きます。
2. Googleアカウント、またはメールアドレスとパスワードでサインアップします。
3. トライアルクレジット $0.50 をワンクリックで受け取ります。1 人 1 回、7 日間有効、カード不要です。
4. ページに表示されたキーをコピーします。
5. 以下のテスト呼び出しを実行します。

ベースURLはhttps://api.grokaiapikey.com/v1、モデルIDはuncensored、キーはAuthorization: Bearerヘッダーに設定します。

キーをテスト

curl から始めます。JSON 応答が返された場合、キー、ベース URL、モデルはすべて正しいです。

Copyexport API_KEY="paste-your-key-here"

curl https://api.grokaiapikey.com/v1/chat/completions   -H "Authorization: Bearer $API_KEY"   -H "Content-Type: application/json"   -d '{"model": "uncensored",
       "messages": [{"role": "user", "content": "Reply with the word ready."}]}'

Node では、公式 OpenAI パッケージは 2 つの設定を変更した後に動作します。

Copyimport OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.grokaiapikey.com/v1",
  apiKey: process.env.API_KEY,
});

const r = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Reply with the word ready." }],
});
console.log(r.choices[0].message.content);

PythonユーザーはOpenAI(base_url=..., api_key=...)で同じことができます。利用可能なメソッドはPOST /v1/chat/completions、POST /v1/responses、GET /v1/modelsです。

キーを環境変数として設定

キーをソースコードに貼り付けないでください。環境変数に配置し、ランタイム時に読み込んでください。コマンドはシステムによって異なります。

Copy# macOS or Linux, current shell session
export API_KEY="paste-your-key-here"

# Windows PowerShell, current session
$env:API_KEY = "paste-your-key-here"

# Check that the variable is set (macOS or Linux)
test -n "$API_KEY" && echo "key is set"

プロジェクトでは、.envファイルに値を保存し、.gitignoreにリストしてください。フレームワークのローダーでそれを読み込みます。サーバーでは、ホストのシークレットストアまたはデプロイメントプラットフォームの環境設定を使用します。このサイトのベースURLはhttps://api.grokaiapikey.com/v1で、秘密ではないためコードに保持しても安全です。

複数のサービスを実行する場合は、それぞれに固有のキーを割り当ててください。チャージ済みのアカウントは最大 5 個のキーを保持できるため、ステージング用、本番用、個人用テストキーをすべて共存させ、それぞれに固有のラベルを付けることができます。

呼び出しが失敗した場合

症状	考えられる原因	修正方法
401 Unauthorized	キーの不足または誤入力	Bearer ヘッダーを確認し、末尾のスペースや引用符を探してください
404 Not Found	間違ったベース URL	パスは api サブドメインの /v1/chat/completions である必要があります
モデルエラー	モデル名が間違っています	モデルIDuncensoredを使用してください
429 レート制限	1分あたりのリクエスト数が多すぎる	トライアルキーは 1 分あたり 60 件の制限があります；速度を落としてください
429 同時実行数	一度に多すぎます	トライアルキーは同時実行 2 件の制限があります；ストリームは終了するまでスロットを保持します

Retry-After: 5ヘッダー付きの429は、一時的な過負荷を意味します。5秒待ってから再試行してください。

リクエスト ID を使用

すべてのレスポンスにはX-Request-Idヘッダーが含まれます。エラーメッセージの横にこれをログに記録してください。サポートチームに失敗した呼び出しについて問い合わせる場合、リクエストIDにより、推測ではなくその正確な呼び出しを見つけることができます。curlでは、レスポンスヘッダーを出力するために-iを追加し、Python SDKでは生のレスポンスヘルパーを使用してそれらを読み取ることができます。

問題が断続的な場合、ヘッダーも役立ちます：X-RateLimit-Limit-RequestsとX-RateLimit-Limit-Concurrencyは、キーに適用される制限を示しており、トライアルキーかフルキーかを一瞥で判断できます。

キーの置換または追加

キーのローテーションを誰かに依頼する必要はありません。API キーページでいつでもキーを再生成（再発行）でき、古いキーは直ちに無効になります。キーが公開リポジトリ、スクリーンショット、または共有チャットに漏れた瞬間にこれを行ってください。

チャージ済みのアカウントは最大5つのキーを保持できます。各キーにstagingやmobile appなどのラベルを付け、他のキーに影響を与えずに単一のキーを取り消すことができます。環境ごとに1つのキーを使用することは良い習慣です。漏洩したstagingキーを取り消しても、本番トラフィックには何のコストもかかりません。

既存のツールでのキーの使用

キーを使用するためにコードを書く必要はありません。多くのチャット用フロントエンドや開発ツールはカスタム OpenAI 互換エンドポイントを受け入れ、SillyTavern はその公開例の 1 つです。セットアップは常に同じ 3 つの値を求めます。

• ベースURLまたはAPI URL： https://api.grokaiapikey.com/v1
• APIキー： コピーしたキー
• モデル名： uncensored

一部のツールは/chat/completionsで終わるフルパスを必要とします。他のツールはそれ自体が追加します。404エラーが発生した場合は、別の形式を試してください。ツールにモデルのドロップダウンがあり、空のままの場合は、モデル名を手動で入力するか、単一のモデルIDを返すGET /v1/modelsからリストを取得させます。

ストリーミングは同じ設定で動作します。単語ごとにではなく一度に返信が表示される場合は、ツールのストリーミング切替スイッチを確認してください。

API キーの安全な管理

• サーバーサイドで保持してください。ブラウザの JavaScript やモバイルアプリのバンドルに配置された API キーは、誰でも読み取ることができます。
• 環境変数から読み込み、最初のコミット前に環境ファイルを .gitignore に追加してください。
• 支出の習慣を身につけましょう。予期せぬ残高の減少に気づけるよう、X-Balance-USD 応答ヘッダーを監視してください。
• 別のサービスには別の API キーを使用してください。そうすれば、他のサービスに障害が発生することなく、1つの API キーのみを取り消すことができます。

テスト呼び出しが成功したら、ストリーミング、関数呼び出し、JSON モードに関する ドキュメント を読み、レートについては 価格ページ を参照してください：入力トークン 100 万トークンあたり $0.15、出力トークン 100 万トークンあたり $0.50 です。クローズドベンダーと比較検討している場合は、開発者が無検閲モデルに移行する理由 に関する当社の記事でトレードオフを確認してください。

シンプルなローテーション手順

1. API キーページで、置き換えたい API キーを作成または再生成してください。再生成すると古い API キーは直ちに無効になるため、コードが新しい値を受け取る準備ができているときに行ってください。
2. API キーが使用されているすべての場所で、環境変数またはシークレットを更新してください。
3. サービスを再起動し、この記事の curl テストを実行してください。
4. メモに日付を記載してください。数ヶ月ごとにカレンダーリマインダーを設定すれば、ほとんどのプロジェクトで十分です。

チャージ後に複数のラベル付き API キーを保持している場合は、1回に1つずつローテーションしてください。ノートパソコンや元チームメイトに紐づく API キーから取り消してください。それらは漏洩する可能性が最も高いからです。

その他のガイド

• Grok API キー無料配布：本当のことと詐欺の見分け方
• Claude APIキー：開発者が無検閲モデルに移行する理由