Kimi API キーが動作しない:原因、修正、フォールバック
Kimi API キーが動作しないエラーが 401、404、429 として表示される場合、原因はほぼ間違いなく以下の 5 つのいずれかです:間違ったベース URL、一致しないキー、残高なし、レート制限、またはエンドポイントが認識しないモデル名。この順で確認してください。
更新日:


主要ポイント
- キーは発行元のプロバイダに対してのみ有効であるため、ベース URL とキーは同じダッシュボードから取得する必要があります。
- 401 はキーが拒否されたことを意味し、404 は通常パスの誤りを、429 は制限に達したかサービスが混雑していることを意味します。
- 他の変更を行う前に、ステータスコードとレスポンスボディを出力してください。
- 1 つの障害でアプリが停止しないよう、2 番目の OpenAI 互換のエンドポイントを設定してください。
まずステータスコードを確認する
何かを再生成する前に、サーバーが実際に何を返したかを確認してください。多くの OpenAI 互換クライアントはボディを汎用的な例外の背後に隠します。ステータスとテキストの両方を出力してください。
curl -i https://api.kimiapikey.com/v1/models \
-H "Authorization: Bearer $YOUR_KEY"
返信の最初の行は、どこを見るべきかを示しています:
| ステータス | 一般的な意味 | 開始方法 |
|---|---|---|
| 401 | キーが拒否されました | キーのコピー、キーとベースURLが異なるプロバイダ由来 |
| 404 | パスまたはモデルが見つかりません | /v1 の欠落、パスの二重化、間違ったモデル ID |
| 400 | リクエストボディが無効 | パラメータ名、メッセージ形式、ボディサイズ |
| 429 | 制限に達したかサービスが混雑 | リクエストレート、同時呼び出し、再試行タイミング |
| 5xx | サーバー側の問題 | バックオフで再試行し、フォールバックに切り替える |
HTTP レスポンスが全く得られない場合(タイムアウトまたは DNS エラー)、問題はネットワークまたは入力したホスト名にあり、キーではありません。
ベース URL とキーはペアである必要があります
これが新しく作成されたキーが失敗する最も一般的な理由です。キーはプロバイダごとに発行されます。1 つのダッシュボードからのキーは、別のプロバイダのサーバーでは単に未知のものであり、キー自体は発行元では完全に有効であっても 401 を返します。
以下の点を確認してください:
- キーとベース URL は同じアカウントページから取得してください。1 つのプロバイダからキーをコピーしたが、設定に古いベース URL を残したままにすると、リクエストは間違った場所へ送信されます。
- 環境変数がコードをシャドーイングしていません。OpenAI SDK は明示的に渡さない場合、
OPENAI_API_KEYとOPENAI_BASE_URLを読み取ります。そのため、古いシェル変数がファイルに書いた値を上書きする可能性があります。 - キーの末尾に空白文字や改行がありません。コピー&ペーストによる末尾の改行は、401 の典型的な原因です。
- ヘッダは正確に
Authorization: Bearer <key>である必要があります。一部のツールは異なるヘッダにキーを期待し、OpenAI 互換モードを有効にする必要があります。
エディタやチャットフロントエンドはさらに一つの罠を加えます。多くのツールは「OpenAI ベース URL」用の別フィールドと、それを有効にする別々のトグルを保持しています。トグルがオフの場合、アプリは新しいキーを使ってデフォルトホストを呼び出し続け、それが悪いキーのように見える 401 を返します。設定を保存し、キャッシュしている場合はアプリを再起動し、複雑なテストの前に短いテストメッセージを送信してください。
Base URL は /v1 で終わるべきであり、ホストや /v1/chat/completions で終わるべきではありません。SDK が残りを付加するため、すでにフルパスを含む URL を使用するとパスが二重になり 404 エラーになります。
地域アクセス、プロキシ、企業ネットワーク
場合によってはキーは正常でも、リクエストが正しいサーバーに到達しないことがあります。プロバイダの利用可否は接続元の地域に依存することがあり、VPN、企業プロキシ、またはファイアウォールルールがトラフィックをブロックまたは書き換えることがあります。サポートされている地域については、プロバイダ自身のドキュメントまたはステータスページを確認し、別のサービスと同じルールが適用されると想定しないでください。
簡単な分離テスト:異なるネットワーク(例えば携帯電話のテザリング)から同じ curl コマンドを実行します。そこで動作すれば、キーは正常でネットワークが原因です。プロキシがHTTPS_PROXYを設定している場合、HTTP ライブラリが実際にそれを尊重しているか確認してください。一部のツールは無視し、接続エラーで失敗します。
残高、クォータ、レート制限の見た目
キーは有効でも、アカウントにクレジットが残っていないか、クォータが使い果たされているため、リクエストを拒否することがあります。コードをデバッグする前にダッシュボードを確認してください。チャージを一度も行ったことがない場合、無料の割り当ては通常小さく、短期間であることを覚えておいてください。
429 は別の話です。これは API キーが悪いのではなく、サーバーがリクエストを遅くしていることを意味します。このサイトで説明されているエンドポイントでは、有効な API キーは同時 8 リクエスト、1 分あたり 300 リクエストまで許可され、無料トライアルキーは同時 2 リクエスト、1 分あたり 60 リクエストまでです。これらを超えると、API はエラーコード rate_limited(1 分あたりのリクエスト数超過)または concurrency(同時接続数超過)を付けて HTTP 429 を返します。一時的な過負荷も 429 を返し、Retry-After: 5 ヘッダーを付加します。
これらの問題のほとんどは、次の 2 つの習慣で解決できます。Retry-After ヘッダーが存在する場合はそれを尊重し、同時実行数を制限値に制限してください。ストリーミングリクエストはストリームが終了するまでスロットを保持するため、ストリームが停止すると、予想以上に割り当てを消費し続けます。
モデル名、パラメータ、ボディサイズ
404 または有効なキーに対する 400 は、通常リクエスト自体を指します。確認すべきことは 3 つあります:
- モデル ID。 各プロバイダーには独自のモデル名があります。
GET /v1/modelsでエンドポイントに提供されているモデルを問い合わせて、返信から ID をコピーします。このサイトでは ID はuncensoredです。 - パラメータ。
max_tokens、temperature、response_formatなどの名前は標準的ですが、プロバイダーはサブセットのみを受け付ける場合があります。リクエストが成功するまでオプションフィールドを削除し、その後 1 つずつ戻してください。 - サイズ。 非常に大きなプロンプトは、モデルが処理する前にボディ制限で失敗することがあります。ここでは最大ボディは 8 MB で、プロンプトと completion を合わせて 100,000 トークンのコンテキストウィンドウです。
ストリーミングは、正常なキーが壊れているように見えるもう 1 つの場所です。stream: trueなしでリクエストが成功し、ありで失敗する場合、原因はエンドポイントではなく、サーバー送信イベントをバッファリングまたは切断するプロキシであることがよくあります。ストリーミングをオフにして確認し、その後プロキシ設定を確認してください。
モデル名のみを変更して呼び出しが失敗した場合、残りの設定が正常であることを確認するために古い名前に戻してください。
フォールバックエンドポイントを準備する
健全なプロバイダでも調子の悪い時間があります。プロダクトが 1 つのキーに依存している場合、単一の障害があなたの障害になります。OpenAI のリクエスト形式は共有されているため、2 番目のエンドポイントを設定し、数行で切り替えることができます。
このサイトのエンドポイントは OpenAI 互換であるため、2 番目のプロバイダとして組み込むことができます。これは Moonshot の公式サービスではなく独立したホスト型のオープンウェイトモデルであり、Kimi モデルとは異なる応答をするため、信頼する前にプロンプトをテストしてください。以下は、プライマリを最初に試行し、エラー時にフォールバックする小さなラッパーです:
import os
from openai import OpenAI
primary = OpenAI(base_url=os.environ["PRIMARY_BASE_URL"],
api_key=os.environ["PRIMARY_KEY"])
fallback = OpenAI(base_url="https://api.kimiapikey.com/v1",
api_key=os.environ["FALLBACK_KEY"])
def ask(messages):
try:
r = primary.chat.completions.create(
model=os.environ["PRIMARY_MODEL"], messages=messages, timeout=30)
except Exception as e:
print("primary failed:", e)
r = fallback.chat.completions.create(
model="uncensored", messages=messages, timeout=60)
return r.choices[0].message.content
print(ask([{"role": "user", "content": "Say hi in five words."}]))
料金は従量課金制です:前払いクレジットから、入力トークン100万トークンあたり$0.15、出力トークン100万トークンあたり$0.50。失敗または拒否されたリクエストには課金されません。そのため、ほとんど実行されないフォールバックの維持コストはほぼゼロです。チャージは$20から開始します。ボーナスのティアについては料金をご覧ください。
2 分でフォールバックをテスト
新規ユーザーは、登録後にAPI キーページでワンクリックで $0.50 のトライアルクレジットを請求できます。カードは不要で、7 日間有効です。これはエンドポイントで実際のプロンプトを 1 回実行するのに十分な時間です。その後、以下のスモークテストを実行してください。
curl https://api.kimiapikey.com/v1/chat/completions \
-H "Authorization: Bearer $FALLBACK_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'
残高クレジットを確認するには、X-Balance-USD レスポンスヘッダーを確認してください。完全なリクエストリファレンスは ドキュメント にあります。これをエディタに組み込む場合、既存のチュートリアル Cursor で Kimi 風 API キーを使用する方法 で Base URL フィールドの場所を確認でき、Kimi API キーの概要 でこのエンドポイントがあなたが使用していたモデルとどのように関連するかを説明しています。
その他のガイド
よくある質問
モデルはMoonshotの公式Kimiと同じですか?
いいえ、当社は無検閲に調整されたオープンウェイトモデルをホストしています。GPT、Claude、Gemini、Grok、DeepSeek、またはその他のベンダーのモデルではありません。独自のサーバーで実行される独自のモデルです。
データを学習に使用しますか?
いいえ。プロンプトや生成結果は学習に使用されません。プライバシーと透明性を重視しており、データはあなたのものです。
レート制限はどのくらいですか?
キーごとに1分あたり300リクエストに制限されます。リクエストボディの最大サイズは8 MBです。これらの制限は、すべてのユーザーに安定したパフォーマンスを提供するために設計されています。
コンテンツポリシーは?
モデルは大人向け、論争的、クリエイティブなトピックについて無検閲です。ただし、未成年者を含む性的コンテンツはブロックされます。これはサブスクリプションレベルに関係なく常に適用される厳格な制限です。
質問と回答
新しい API キーでなぜすぐに 401 になるのですか?
最も一般的な原因は、キーを別のプロバイダーのベース URL に送信していること、コピーしたキーに不要なスペースや改行が含まれていること、または環境変数がコードを上書きしていることです。SDK の問題を除外するために curl でテストしてください。
429 エラーはキーの誤りと同じ意味ですか?
いいえ。429 はレート制限、同時実行数制限、または一時的な過負荷に達したことを意味します。キーは有効です。Retry-After の値を待って、同時リクエストの数を減らしてください。
失敗したリクエストには料金が発生しますか?
いいえ。失敗または拒否されたリクエストはこのエンドポイントでは課金されません。そのため、失敗した呼び出しを再試行してもクレジットが消費されることはありません。
このエンドポイントを Kimi モデルのそのまま置き換え可能として使用できますか?
同じ OpenAI のリクエスト形式を使用するため、コードの変更はベース URL、API キー、およびモデル ID uncensored のみです。基盤となるモデルは異なるため、応答は一致しません。まずプロンプトをテストしてください。
キーはフォーム 1 つで手に入ります
アカウントを作成し、キーをコピーし、ベースURLを変更します。これでセットアップは完了です。