Cursor に自分の API キーと Base URL を設定する
Cursor の OpenAI API Key に RelaySwitch のキーを入力し、Override OpenAI Base URL を https://api.relayswitch.io/v1 にすると、そのキーで呼べるチャットモデルを Cursor のモデル選択に追加できます。Agent モードと Ask モードのどちらでも使えます。
01Cursor で自分の API キーを使う仕組み
Cursor は OpenAI 形式でリクエストを送ります。RelaySwitch のモデル一覧にあるチャットモデルは、すべてこの形式に応答します。そのため、1 つのキーで Claude、GPT、Gemini、DeepSeek を同じモデル選択に並べられ、それぞれカタログの単価で前払い残高からトークン単位で課金されます。
同じキーは、ターミナルで使う Claude Code や Codex CLI にもそのまま設定できます。
02設定の手順(Cursor Settings → Models)
設定は Cursor Settings(Cmd/Ctrl + ,)の Models にあります。キーと Base URL の入力欄は、モデルの一覧の下です。入力後の状態は、手順の下の例のようになります。
- OpenAI API Key をオンにして、コンソールで発行したキーの全文を貼り付けます。
- Override OpenAI Base URL をオンにして、https://api.relayswitch.io/v1 を入力します。末尾の
/v1まで含めます。 - Save をクリックします。古いバージョンの Cursor では、このボタンは Verify という名前です。
- Models に、使いたいモデルの ID を 1 つずつ追加します。モデル一覧に表示されている ID と完全に同じ文字列にします。Claude の ID も追加できます。
- チャットパネルで、追加したモデルを選びます。
OpenAI API Key: sk-relay-...Override OpenAI Base URL: https://api.relayswitch.io/v1Models: gpt-6.1-sol03各設定項目の意味
| OpenAI API Key | Cursor がリクエストごとに送る認証情報です。コンソールのキーを全文貼り付けます。 |
| Override OpenAI Base URL | リクエストの送り先を、OpenAI ではなく https://api.relayswitch.io/v1 に変えます。 |
| Models | モデル選択に表示される一覧です。使いたい ID を 1 つずつ、モデル一覧の表記どおりに追加します。表示名ではなく ID を書きます。 |
04curl で同じリクエストを確認する
Cursor が送るのと同じ形式のリクエストを、同じマシンから curl で送ります。200 と JSON が返れば、キーと Base URL は正しく設定されています。curl に -i を付けるとレスポンスヘッダーが表示され、リクエストの ID と、ストリーミングでない応答では米ドルの課金額を確認できます。
次に Cursor で、追加した ID を選んでメッセージを送ります。そのリクエストは、トークン数と料金とともにコンソールの利用履歴に表示されます。
curl https://api.relayswitch.io/v1/chat/completions \ -H "Authorization: Bearer sk-relay-..." \ -H "content-type: application/json" \ -d '{"model": "gpt-6.1-sol", "messages": [{"role": "user", "content": "Reply with ok"}]}'05モデルの選び方と料金
Agent モードのリクエストには、会話、Cursor が読んだファイル、ツールの実行結果が含まれるため、請求のほとんどは入力トークンです。入力単価の低いモデルほど、1 リクエストあたりの費用は低くなります。入力、キャッシュ入力、出力の単価は、各モデルのページに載っています。
下の表は主要モデルの現在の単価です。単位は米ドル / 100 万トークンで、全 322 モデルはモデル一覧にあります。
| モデル | 開発元 | 入力 | 出力 | コンテキスト |
|---|---|---|---|---|
| Claude Fable 5.2claude-fable-5.2 | Anthropic | $4.00≈ ¥653 | $20.00≈ ¥3,264 | 1,000,000 |
| Claude Opus 5.5claude-opus-5-5 | Anthropic | $2.716≈ ¥443 | $9.70≈ ¥1,583 | 1,000,000 |
| DeepSeek V4.1 Flash 1017deepseek-v4.1-flash-1017 | DeepSeek | $0.2425≈ ¥40 | $1.164≈ ¥190 | 1,048,576 |
| GLM 5.3 Flashglm-5.3-flash | Z.ai | $0.0873≈ ¥14 | $0.1455≈ ¥24 | 1,000,000 |
| GPT-6 Lunagpt-6-luna | OpenAI | $0.0625≈ ¥10 | $0.20≈ ¥33 | 1,050,000 |
| Qwen3.8 Maxqwen3.8-max | Qwen | $0.80≈ ¥131 | $2.40≈ ¥392 | 991,000 |
| Minimax M3.1 Flashminimax-m3.1-flash | MiniMax | $0.105≈ ¥17 | $0.42≈ ¥69 | 1,000,000 |
| Gemini 3.8 Flashgemini-3.8-flash | $0.4925≈ ¥80 | $2.25≈ ¥367 | 1,048,576 | |
| Grok 4.7grok-4.7 | xAI | $0.60≈ ¥98 | $1.80≈ ¥294 | 500,000 |
| Kimi K3kimi-k3 | Moonshot AI | $0.90≈ ¥147 | $4.50≈ ¥734 | 1,048,576 |
米ドル / 100 万トークン · ≈ は欧州中央銀行の 2026-11-13 のレートで換算した日本円の参考価格で、課金は米ドルです
06Agent モードで GPT モデルを使うとき
Base URL を上書きした状態では、Cursor の Agent モードは GPT モデルに対して、Responses API 形式のボディを Chat Completions のパスに送ります。Cursor はこれを既知の問題としてフォーラムに載せています。
ゲートウェイはこのボディを、それが表す Chat Completions のリクエストとして読み取り、Chat Completions 形式で応答します。ストリーミングでもそうでなくても同じです。GPT の ID は Agent モードでも Ask モードでも、同じ料金で使えます。
07課金、キャッシュ、Cursor 側の料金
- リクエストは、モデルの単価で前払い残高からトークン単位で課金されます。
- レスポンスがキャッシュ入力のトークン数を報告した場合、その分は入力単価ではなくキャッシュ入力の単価で課金されます。同じ先頭部分を繰り返す長いチャットは、新しいチャットより 1 ターンあたりの費用が低くなります。
- Cursor の Teams プランと Enterprise プランでは、自分のキーを使ったリクエストも Cursor の利用量に数えられ、Cursor 独自のトークン単位の料金が加算されます。この料金は Cursor が請求するもので、RelaySwitch の請求ではありません。個人向けプランは対象外です(Cursor の API キーに関するドキュメントによる)。
よくある質問
- Cursor で Claude のモデルは使えますか?
- 使えます。Cursor は OpenAI 形式でリクエストを送り、カタログのチャットモデルはすべてこの形式に応答します。Models に Claude の ID を追加すれば、GPT、Gemini、DeepSeek と同じモデル選択に表示されます。
- Override OpenAI Base URL に /v1 は付けますか?
- 付けます。https://api.relayswitch.io/v1 をそのまま入力してください。Cursor がその後ろに /chat/completions を付け足します。Verify(Save)に失敗する原因で最も多いのは、/v1 の付け忘れです。
- ストリーミングの設定は必要ですか?
- 必要ありません。Cursor は既定でストリーミングを使い、切り替えのスイッチはありません。すべてのモデルがストリーミングに対応しています。
- Cursor のプランの料金とは別に、費用がかかりますか?
- RelaySwitch 側の費用は、使ったトークンの分だけです。Cursor の Teams プランと Enterprise プランでは、自分のキーを使ったリクエストにも Cursor 独自の料金が加算され、これは Cursor が請求します。個人向けプランは対象外です。詳細は Cursor の API キーに関するドキュメントで確認してください。
- 401、402、404 が返るときは、何を確認すればよいですか?
- 401 invalid_api_key はキーの誤りまたは失効です。コンソールからコピーし直します。404 model_not_found は、Models に追加した ID がモデル一覧にありません。綴りの誤りか、ID の代わりに表示名を書いていないかを確認します。402 insufficient_balance は残高不足で、コンソールでチャージするとすぐに使えるようになります。
- Cursor と Claude Code で同じ API キーを使えますか?
- 使えます。Base URL を設定できるツールなら、同じキーと同じ残高を使えます。Cursor は OpenAI 形式、Claude Code は Anthropic Messages 形式で接続し、どちらも同じ Base URL で受け付けます。