AZZ API

Cursorで中継APIを利用するガイド：カスタムBase URL設定

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

1. Cursorとは

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

中継サービス（リレー）を利用することで、Cursorの公式サブスクリプションを購入しなくても、サイト内で発行した sk- キーを使用し、トークン課金制でClaude / GPT / Geminiモデルを利用可能です。

2. 準備

  1. Gezhi APIコンソールにログインし、「APIキー（API 密钥）」セクションで専用の sk-xxxxxx キーを生成します。
  2. 「モデル価格（模型定价）」で、使用するモデルのslug（例：claude-sonnet-5、gpt-5.4、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を入力します：各プロバイダーに対応するゲートウェイ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の設定ミスではありません。

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