cursorapikey.com/ガイド
Cursor APIキーが機能しない:カスタムエンドポイントの修正
Cursor APIキーが機能しない場合、原因はほぼ常に4つのうちの1つです:ベースURL、モデル名、キー自体、またはアカウントの制限です。curlコマンド1つでそれがわかります。
更新日:


主要ポイント
- まずcurlでCursorの外でキーをテストしてください。curlが動作すれば、問題はCursorの設定にあります。
- ベースURLはhttps://api.cursorapikey.com/v1でなければならず、モデル名はuncensoredと正確に一致する必要があります。
- 401はキーの誤り、404はURLの誤り、429はレートまたは同時実行数の制限、モデルエラーはモデル名の誤りを意味します。
- メニューラベルはCursorのバージョン間で変更されるため、正確な表記よりもフィールドの目的に合わせてください。
ステップ1:Cursor外でキーをテストする
Cursorを除外してください。単純なリクエストが成功すれば、キーとアカウントは正常であり、問題はエディタの設定にあります。失敗した場合、エラーレスポンスボディに問題の原因が記載されます。
curl -i https://api.cursorapikey.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Reply with the word ready."}]}'
-iフラグはステータス行とヘッダーを出力します。200ステータスでchoices配列が存在する場合、成功を意味します。X-Balance-USDヘッダーは残高クレジットを示します。認証エラーや支払いエラーが発生した場合は、まずこれを確認してください。
モデルを一覧表示することもできます。これにより、何も消費せずにキーを確認できます:
curl https://api.cursorapikey.com/v1/models -H "Authorization: Bearer YOUR_KEY" | grep uncensored
レスポンスにはモデルIDuncensoredが含まれているはずです。
ステップ2:Cursorでフィールドを設定する
Cursorの設定を開き、Modelsセクションを見つけてください。3つの値が必要で、いずれに誤りがあると、キーが壊れたように見える失敗が発生します。
- OpenAI APIキー:両端にスペースや改行がないようにキーを貼り付けてください。
- OpenAIベースURLの上書き:上書きを有効にし、
https://api.cursorapikey.com/v1を入力してください。/v1は維持し、/chat/completionsは含めないでください。 - カスタムモデル:
uncensoredという名前のモデルを追加し、有効にしてください。使用しないモデルは無効にしてください。そうしないと、エンドポイントがサポートしていないモデルがCursorによって選択される可能性があります。
保存後、お使いのバージョンに検証オプションがあればそれを使用し、チャットモデルのドロップダウンでuncensoredを選択してください。古いタブは起動時のモデルを引き継ぐ可能性があるため、新しいチャットタブがテストに適しています。より多くのコンテキスト付きで同じセットアップを示すCursor APIの使用方法のステップバイステップの手順をご覧ください。
エラーと修正方法を一致させる
| 表示される内容 | 考えられる原因 | 修正方法 |
|---|---|---|
| 401、"無効なキー"、"認証エラー" | キーの誤入力、切り捨て、または失効 | キーページから再度コピーし、末尾のスペースを確認してください |
| 404、"見つかりません" | URLが間違っている、/v1が欠けている、またはパスが重複している | 正確にhttps://api.cursorapikey.com/v1を使用してください |
| 「モデルが見つかりません」または類似のエラー | モデル名がuncensoredと異なる | その正確な名前(小文字)でカスタムモデルを追加してください |
429 とrate_limited | 1分あたりのリクエスト数制限を超えた | リクエスト速度を落としてください。トライアルキーは1分あたり60件、フルキーは300件まで許可されます |
429 とconcurrency | 一度にリクエストが多すぎる | 並列エージェント実行を減らす;トライアル2、フルキー8 |
429 とRetry-After: 5 | 一時的な過負荷 | 5秒待ってから再試行してください |
| curlでは動作するが、Cursorでは失敗する | 設定が保存されていない、タブのモデルが間違っている、またはカスタムキーを使用しない機能 | 次のセクションを参照してください |
失敗または拒否されたリクエストは課金されません。デバッグ中に再試行してもコストはかかりません。
curlは動作するがCursorは依然として失敗する
これは最も混乱を招くケースであり、いくつかの一般的な説明があります。
間違ったモデルが選択されています。 Cursorはリストに独自のビルトインモデルを保持しています。それらのいずれかが選択されている場合、リクエストはエンドポイントにまったく送信されません。使用しているチャットまたはコンポーザーのドロップダウンでuncensoredを明示的に選択してください。
すべての機能がキーを使用するわけではありません。 インラインオートコンプリートなどCursor独自のモデルに依存する機能は、追加したキーに関係なくそれらを使い続ける場合があります。カスタムキーはモデルを選択できるチャットと編集モードで適用されます。これはリリース間で変更されるため、Cursorの現在のドキュメントを確認してください。
エージェントモードからの同時リクエスト。 エージェントとマルチステップのリクエストは、一度に複数のリクエストを発生させる可能性があります。トライアルキーは同時に2つのリクエストまで許可します。エラーがエージェントモードでのみ表示される場合、おそらくconcurrency制限に達しており、フルキーではそれが8に引き上げられます。ストリーミングリクエストはストリーミングが終了するまでスロットを保持するため、長い出力はスロットをより長く占有します。
ツール呼び出し。 APIはツール呼び出しをサポートしており、tool_callsがストリーミングされ、結果はrole: "tool"として返されます。ツール使用の品質はモデルに依存するため、エージェントの実行がツールステップで停止する場合は、まずプレーンチャットで同じタスクを試してください。
アカウント側を確認する
curlが残高に関するエラーを返す場合、キーは有効ですがクレジットが空か、トライアルが終了しています。トライアルは$0.50で、有効期限は7日間です。サインアップ後のAPIキーページでワンクリックで取得できます。その後、チャージが必要です。
チャージは$20から$500までの任意の整数金額で行え、$50以上で+5%、$100以上で+10%、$200以上で+15%のボーナスが付きます。暗号資産(TRC20上のUSDT、Base上のUSDC)で支払いできます。価格表ページに表が記載されています。まだキーをお持ちでない場合は、こちらで取得してください。
ツールごとに1つのキーを保持してください。キーを複数のエディタやスクリプトに貼り付けた場合、レート制限はそれら全体で共有されるため、ランダムな失敗のように見えることがあります。
頑固なケース用のスクリプトチェック
まだ原因がわからない場合は、エディタが行っている処理を模倣する短いスクリプトを実行してください。これはCursorスタイルのクライアントがモデルとしているOpenAI SDKを使用し、正確なエラーオブジェクトを出力します。
from openai import OpenAI, APIStatusError
client = OpenAI(base_url="https://api.cursorapikey.com/v1", api_key="YOUR_KEY")
try:
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Write a one-line Python hello world."}],
stream=True,
)
for chunk in r:
print(chunk.choices[0].delta.content or "", end="")
except APIStatusError as e:
print(e.status_code, e.response.headers.get("X-Request-Id"))
print(e.response.text)
スクリプトがテキストをストリーミングする場合、エンドポイント、キー、モデルは正しく、残りの問題はCursorの設定です。ステータスコードを出力する場合は、上記の表を使用してください。サポートに連絡する際はX-Request-Idの値を保持してください。これは正確なリクエストを識別します。パラメータの詳細はドキュメントページにあります。
再び壊れないようにする
いくつかの習慣でほとんどの繰り返し問題を防げます。チャットログやメモではなく、1つのパスワードマネージャーエントリにキーを保存し、そこからコピーしてください(改行が紛れ込む可能性があります)。エディタの更新後にそれらを入力し直せるように、3つの値(ベースURL、キー、モデル名)をメモしてください。更新後、実際の作業を開始する前に短いチャットメッセージを1つ送信してください。
残高を確認してください。X-Balance-USDヘッダーは各レスポンスで返され、GET /v1/balanceからも取得できます。クレジットは期限切れにならないため、アカウントに残っている適度なチャージ額も無駄になりません。キーをエディタだけでなくスクリプトでも使用する場合は、長いバッチジョブにリトライループを実装してください。429応答時には5秒待機し、数回の試行で停止するようにします。これにより、スクリプトがエディタの同時実行数スロットを枯渇させるのを防げます。
コストチェックと次の読み物
ファイルコンテキスト10,000トークンと700トークンの回答を含むコーディングチャットリクエストの場合、入力は10,000 / 1,000,000 x $0.15 = $0.0015、出力は700 / 1,000,000 x $0.50 = $0.00035で、合計約$0.00185かかります。料率は1M入力トークンあたり$0.15、1M出力トークンあたり$0.50です。Cursor APIの価格表に関する記事には月次見積もりが記載されています。
失敗したリクエストが大きなものであった場合、ウィンドウを覚えておいてください:プロンプトと補完の合計は100,000トークン以内に収まり、リクエストボディは8 MBに制限されています。チャットにリポジトリ全体を添付すると、両方を超過する可能性があります。コンテキストを重要なファイルに絞り込んで再試行してください。
その他のガイド
質問と回答
なぜCursorはAPIキーが無効だと言うのですか?
通常、キーに不要なスペースが含まれているか、部分的にコピーされたか、ベースURLが別のサービスを指しています。キーを再コピーし、オーバーライドURLがhttps://api.cursorapikey.com/v1であることを確認してください。
どのモデル名を入力すればよいですか?
小文字のuncensoredを入力してください。これがAPIが提供する唯一のモデルIDです。
オートコンプリートは私のキーを使用しますか?
必ずしもそうではありません。Cursor の一部の機能は Cursor 独自のモデルを使用しており、カスタムキーは主にモデルを選択できるチャットおよび編集モードに適用されます。
失敗したリクエストは課金されますか?
いいえ。失敗または拒否されたリクエストは課金されません。デバッグ中に再試行しても追加料金はかかりません。