Cursor

Cursor のカスタム OpenAI API 設定

Cursor に BetterToken API Key、Override OpenAI Base URL、GPT モデル ID を設定。401 とモデル未検出エラーへの対処も確認できます。

短い答え

BetterToken を Cursor の Custom OpenAI API として接続するには、BetterToken API Key を入力し、Override OpenAI Base URL を有効にして https://bettertoken.ai/v1 を設定します。次に、モデル広場から現在の GPT モデル ID を追加します。API Key、Base URL、モデル ID はすべて同じプロバイダーに属している必要があります。

BetterToken の公開 Base URL は https://bettertoken.ai/v1 です。

この情報が役立つ場面

Cursor でサードパーティの OpenAI 互換プロバイダーを使用したいとき
Override OpenAI Base URL を設定する必要があるとき
カスタムモデルを追加するとき
モデルが見つからない、または認証に失敗するとき
Cursor、Codex、その他のツールで 1 つのモデルルーティングレイヤーを共有したいとき

項目の意味

項目	役割
API Key	認証情報
Base URL	OpenAI 互換エンドポイント。通常は `/v1` URL
モデル ID	プロバイダーが認識するモデル識別子
カスタムモデル	Cursor 内で手動追加または選択するモデル

推奨手順

プロバイダーのダッシュボードで API Key を作成します。
Cursor のモデル設定で API Key を追加します。
Override OpenAI Base URL にプロバイダーの Base URL を入力します。
プロバイダーがサポートするモデル ID を追加または選択します。
保存し、簡単なリクエストで確認します。

トラブルシューティング

401 Unauthorized

BetterToken API Key に余分な空白がなく、Cursor が https://bettertoken.ai/v1 を使用していることを確認してください。あるプロバイダーの API Key と別のプロバイダーの Base URL を混在させないでください。Key を再生成または無効化した場合は、Cursor で置き換えて再試行します。

Model Not Found または 404

画面の表示名ではなく、BetterToken Model Plaza に表示される正確な API Model ID を使用してください。モデルが OpenAI 互換エンドポイントで利用でき、Base URL が /v1 で終わることを確認します。

プライベートネットワークへのアクセスは禁止されています

Cursor は localhost、127.0.0.1、プライベート LAN アドレス、その他の非公開エンドポイントを拒否する場合があります。BetterToken では公開 HTTPS Base URL https://bettertoken.ai/v1 を維持してください。ローカルプロキシを使う場合は、Cursor の現在のローカルネットワーク制限に従ってください。

よくある間違い

401 Unauthorized: 有効な BetterToken API Key を使用し、余分な空白を削除します。
404 Not Found: 完全なリクエストパスではなく、https://bettertoken.ai/v1 を Base URL として使用します。
あるプロバイダーの API Key と別のプロバイダーの Base URL を使用すること。
モデル広場から正確な Model ID をコピーしてください。
API モデル ID の代わりに UI 表示名を使用すること。
Cursor Rules が API 認証に影響すると考えること。
グローバル上書きが他の OpenAI モデルに影響する可能性を忘れること。

BetterToken について

Claude Code には https://bettertoken.ai、Codex CLI と OpenAI-compatible ツールには https://bettertoken.ai/v1 を使用します。クライアントのプロトコルに合わせて接続先を選びます。モデル広場から正確な Model ID をコピーしてください。

Claude Code の https://bettertoken.ai を Cursor の OpenAI 互換設定に入力しないでください。