Cursor AI API キー：カスタムキーの配置場所

短い答え

Cursor 系エディターはカスタムプロバイダーと通信するために 3 つの値が必要です：ベース URL、API キー、モデル名です。このサービスの場合、それらは次の通りです：

• ベース URL：https://api.cursoraiapikey.com/v1
• API キー：API キーページからのキー
• モデル名：uncensored

エディターの設定を開き、モデルセクションを探します。CursorにはOpenAI APIキー用のフィールドと、OpenAI base URLを上書きするオプションが用意されていますが、メニューのラベルはバージョンによって移動するため、見つからない場合は設定内で「base URL」を検索してください。URLとキーを貼り付け、uncensoredという名前のカスタムモデルを追加し、お使いのバージョンに検証ボタンがある場合はそれを使用します。

このサービスは Cursor とは独立しています。これは別個のホスト型 API であり、エディター自体のアカウントやプランを置き換えるものではありません。あなたはエディターのチャットを別の OpenAI 互換サーバーに向けただけです。

2 種類のキー、2 つの異なる場所

人々は2つの無関係な物事に同じ言葉を使っているため、それらを混同することがセットアップ失敗の最も一般的な理由です。

アカウントログイン

エディターには独自のログインがあります。これはエディターのベンダーに対してあなたを識別するもので、モデルプロバイダーとは無関係です。プロバイダーキーをログイン画面に貼り付けることはありません。

プロバイダーキー

これはモデルを実行する会社が発行する秘密の文字列です。これをベース URL と一緒にモデル設定に貼り付けると、エディターはすべてのリクエストに Authorization: Bearer ヘッダーを付けて送信します。このサービスのキーはこのサービスのベース URL に対してのみ機能し、他のプロバイダーのキーはここでは機能しません。

エディター固有のキーを無料で入手する方法を探してここに来た場合、これはそれではありません。エディターのチャットパネルの背後にある安価なテキストモデルが必要な場合は、以下をお読みください。このパターンは、OpenAI 互換のエンドポイントを受け入れるあらゆるエディターで機能し、Claude キーの置き換えに関する記事では、Anthropic 形式のセットアップに対する同等のケースを扱っています。

エディターに触れる前にエンドポイントをテスト

エディター外での 2 分間のテストで、問題がキーにあるのかエディターにあるのかがわかります。アカウントを作成し、キーページでトライアルを受け取り、以下を実行してください：

Copycurl https://api.cursoraiapikey.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 ok."}]
  }'

choices配列を含む JSON 本文が返されるはずです。レスポンスヘッダーには X-Balance-USD が含まれており、クレジットの残高が表示されます。公式 SDK を使用した Python での同じ呼び出し：

Copyfrom openai import OpenAI

client = OpenAI(
    base_url="https://api.cursoraiapikey.com/v1",
    api_key="YOUR_KEY",
)

reply = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Reply with the word ok."}],
)
print(reply.choices[0].message.content)

両方の呼び出しが機能する場合、キーは正常であり、その後のエラーはエディターの設定に起因します。

エディターでの手順

1. Google またはメールアドレスとパスワードでサインアップし、API キーページで $0.50 のトライアルクレジットを受け取ってください。カードは不要で、7 日間有効です。
2. キーをコピーします。パスワードのように扱ってください。
3. エディターで設定を開き、モデルセクションに移動します。バージョンによって名称が異なるため、このリストのラベルをガイドとして扱ってください。
4. キーをOpenAI APIキーフィールドに貼り付けます。
5. OpenAI ベース URL を上書きするオプションを有効にし、https://api.cursoraiapikey.com/v1 を入力します。/v1 を維持し、/chat/completions を追加しないでください。クライアントが残り部分を付加します。
6. 正確な名前 uncensored でカスタムモデルを追加します。
7. チャットパネルでそのモデルを選択し、短いメッセージを送信します。

お使いのバージョンで検証ステップが失敗し、curlでは動作する場合、キーの末尾に空白が残っていないこと、base URLの末尾に2つ目の/v1がないことを確認してください。

キーが使用される機能とされない機能

カスタムエンドポイントの設定が必ずしもすべての機能を変更するわけではありません。エディターはインライン補完や差分の適用などの一部の機能をベンダーがホストするモデルで実行することが多く、それらはあなたのキーを無視する場合があります。チャットとエージェントスタイルのリクエストは、通常、構成したエンドポイントに送信されます。エディターのドキュメントがあなたのバージョンの権威であるため、特定の機能に合わせて計画を立てる前に確認してください。

確認すべきもう 2 つのこと：

• リクエストパス。 バージョンによっては、リクエストがあなたのエンドポイントに到達する前にエディターのベンダーが実行するサーバーを経由する場合があります。その場合、あなたのパソコン上のベース URL は機能せず、このような公開 URL は機能します。エディターが何を保存するかを確認するには、プライバシーノートをお読みください。
• モデルのスコープ。 このサービスは、法的に成人が利用する用途に対してコンテンツ拒否なしで回答するように調整された 1 つのオープンウェイトモデルを実行しています。テキストのみです。画像、音声、埋め込みを生成しないため、それらが必要な機能はこのモデルでは機能しません。

コンテキストウィンドウは、プロンプトと補完を合わせて 100,000 トークンであり、ほとんどの単一ファイルの作業や多くのマルチファイルタスクには十分です。非常に大きなリポジトリのダンプは収まりません。

よくあるエラーの修正

症状	考えられる原因	修正方法
401 認証エラー	キーの誤りまたは取り消し、余分な空白、キーの誤ったフィールドへの貼り付け	キーページでキーを再生成し、再度貼り付けてください。古いキーは直ちに無効になります。
404 見つかりません	ベース URL に /v1 が不足、または /v1/v1 が重複	正確に https://api.cursoraiapikey.com/v1 を使用してください。
モデルが見つからない	カスタムモデル名の入力ミス	名前は uncensored で、すべて小文字です。
concurrency による 429	一度にリクエストが多すぎます。トライアルキーは 2 件まで許可されます	実行中のリクエストが完了するのを待つか、8つの同時リクエストを許可するフルキーに切り替えてください。
rate_limited による 429	1分あたりの制限を超えました。トライアルキーでは60、フルキーでは300です。	処理を遅くしてください。エージェントのループではバーストが発生する可能性があります。
429 と Retry-After: 5	一時的な過負荷	5秒後に再試行してください。

エージェントモードでは複数のリクエストが同時に実行され、ストリーミングレスポンスはストリーミングが終了するまでスロットを保持します。トライアルキーでは、これが同時実行数の制限に達しやすい原因となります。これは通常の状態であり、キーの欠陥ではありません。

リクエストの費用

課金は従量制で、入力トークン 1M あたり $0.15、出力トークン 1M あたり $0.50 で、前払いクレジットから差し引かれます。失敗または拒否されたリクエストには課金されません。エディタでの典型的なチャットターンでは、開いているファイルといくつかの履歴を送信し、例えば 20,000 入力トークンで 1,500 出力トークンを受け取ります：

• 入力: 20,000 x $0.15 / 1,000,000 = $0.0030
• 出力: 1,500 x $0.50 / 1,000,000 = $0.00075
• 合計: $0.00375、半分セント未満

したがって、$0.50の無料トライアルクレジットは、そのサイズの会話で約133ターンをカバーします。これは、午後の実際のテストには十分です。継続することにした場合、チャージは$20から$500まで整数金額で実行され、$50以上で5%ボーナス、$100以上で10%ボーナス、$200以上で15%ボーナスが得られます。暗号資産（TRC20上のUSDTまたはBase上のUSDC）で支払われます。クレジットは期限切れになりません。価格表ページに完全な表があり、ドキュメントにはサポートされているすべてのパラメータがリストされています。

その他のガイド

• Cursor AIの料金体系とAPI：サブスクリプションまたはトークン単位の課金
• 無検閲利用のためのClaude APIキーの代替案