AZZ API

CursorへのAPI連携チュートリアル：カスタムBase URL設定

  • 发布时间
  • 语言ja

CursorのSettings → ModelsでカスタムAPIキーとBase URLを設定することで、独自のキーを使用してClaude / GPT / Geminiモデルを呼び出すことができます。

1. Cursorとは

Cursorは、VS Codeをベースに構築されたAIネイティブなコードエディタであり、AIチャット、コード生成（Composer/Chat）、インテリジェントなコード補完が深く統合されています。BYOK（Bring Your Own Key）に対応しており、独自のAPIキーを使用して外部のモデルエンドポイントに接続できるため、公式サブスクリプションを購入したくない場合や、特定のモデルに統一して切り替えたい場合に最適です。

APIゲートウェイを介して接続することで、Cursorの公式サブスクリプションを購入することなく、プラットフォームで発行した sk- キーを使用して、トークン課金制でClaude / GPT / Geminiモデルを利用できます。

2. 準備

  1. 「極智API（Jizhi API）」コンソールにログインし、「APIキー」セクションで独自の sk-xxxxxx キーを生成します。
  2. 「モデル価格」で、使用するモデルのslug（例：claude-sonnet-5、gpt-5.5、gemini-3.7-flash）を確認します。
  3. ゲートウェイアドレス：https://www.relay-api.com を確認します。

3. Cursorでの設定方法

Cursor → Settings → Models → API Keys を開くか、設定画面で Models を検索します：

  1. 利用するモデルプロバイダーを選択します（OpenAIの場合はOpen AI項目、Claudeの場合はAnthropic項目、Geminiの場合はGoogle Gemini項目を選択）。
  2. API Key を入力します：sk-あなたのキー。
  3. Override Base URL を入力します：選択したプロバイダーに応じて対応するゲートウェイを入力します。
    • Claude / Anthropic：https://www.relay-api.com
    • GPT / OpenAI：https://www.relay-api.com/v1
    • Gemini：https://www.relay-api.com/v1beta
  4. Models リストに使用する正確なモデルIDを追加します（モデル一覧からslugをコピーしてください。表示名を入力しないでください）。
  5. Verify をクリックして接続を確認します。その後、通常のチャットで短いテキストを送信し、正しくレスポンスが返るか確認してください。

4. トラブルシューティング

現象対処法
401 / 403キーが無効、未有効化、または残高不足です。sk-キーが正しいか確認し、チャージを行ってください。
404 / モデル利用不可モデルのslugがプラットフォームのものと一致していないか、そのモデルが有効化されていません。モデルIDを再確認してください。
Verifyは成功するがAgentで失敗する/chat/completions プロトコルの違いに起因します。まずは通常のチャットで基本的な疎通を確認してください。
Tab補完が効かないTab補完などの専用機能はCursorの内蔵モデルを使用します。これは製品の仕様範囲であり、Base URLの設定の問題ではありません。

セキュリティに関するアドバイス：APIキーは公開リポジトリにコミットしないでください。プロジェクトごとに個別のキーを作成し、残高や使用履歴を定期的に確認することを推奨します。

Base URLに関する補足：当サイトは /v1beta/models/... と /v1beta/v1beta/models/...（および /v1/... と /v1/v1/...）の両方を受け入れるため、クライアント側で /v1 や /v1beta を自動補完するかどうかは呼び出しに影響しません。ドメインのルートURLを入力しても、/v1beta を含むアドレスを入力しても動作します。モデルIDについては、コンソールの「トークン」ページ右上にある「モデルID」からコピーしてください。