Cursor で BeatAPI を使う

Cursor は AI コードエディターです。モデル設定で OpenAI 互換のエンドポイントを指定できるため、拡張機能なしで BeatAPI をカスタム接続先として設定できます。

前提条件

1. Cursor がインストールされていること。
2. BeatAPI API キー。 ダッシュボード → API キーで作成します。

ステップ 1：モデル設定を開く

右上の歯車アイコン、または macOS の Cmd+Shift+J、Windows/Linux の Ctrl+Shift+J で設定を開き、サイドバーの Models を選択します。

ステップ 2：BeatAPI を指定する

OpenAI API Key セクションで Override OpenAI Base URL を有効にし、次を入力します。

保存後、対応する短いチャットリクエストを送信し、BeatAPI の利用状況に該当する記録があるか確認します。

ステップ 3：利用するモデルを追加する

Cursor は独自のモデル一覧を持ちます。一覧にあるだけでは、カスタムキーで利用できるとは限りません。Cursor の 独自 API キーのガイドでは、OpenAI カスタムキーの対象を、対応する標準的な非推論チャットモデルに限定しています。現在 Cursor が許可するモデルを確認し、GET /v1/models で取得した、BeatAPI アカウントで利用できる正確な ID を選び、短いチャットで動作を確認してから使ってください。BeatAPI が OpenAI 互換だからといって、Cursor の OpenAI キー上書きで Claude や推論モデルが使えるとは限りません。

カスタムキーが適用されるのは対応するチャットリクエストです。Cursor Tab の補完は引き続き Cursor の組み込みモデルを使います。モデル設定の成功は、すべての Cursor 機能が BeatAPI を使うことを意味しません。実際のリクエストを BeatAPI の利用状況で確認してください。

ステップ 4：利用する

• チャットは Cmd+L / Ctrl+L を押し、質問や作業内容を入力します。
• インライン編集はコードを選択し Cmd+K / Ctrl+K を押します。選択したモデルと現在の Cursor バージョンで、そのリクエストがカスタムキーを経由するか確認してください。
• Tab 補完は BeatAPI のカスタム接続先ではなく、Cursor の組み込みモデルを使います。

@filename でファイル、@folder でディレクトリを参照すると、開いているバッファーから推測させず、必要なコンテキストを渡せます。

よくある質問

Cursor が BeatAPI に接続できません

1. Base URL は正確に https://api.beatapi.io/v1 を指定します。
2. ダッシュボード → API キーでキーが有効か確認します。
3. 社内プロキシを使う場合は api.beatapi.io への通信を許可します。

一覧にあるモデルが動作しません

一覧は Cursor 独自のものです。アカウントで実際に提供される ID だけが応答します。現在のカタログは料金ページを参照してください。

402 insufficient_credits

残高が 0、またはリクエストの料金に不足しています。ダッシュボードからチャージしてください。

429 rate_limit_exceeded

キーのリクエスト数が上限を超えました。そのキーの BeatAPI 利用状況を確認し、対応モデルを選ぶか、ダッシュボードでキーの許容量を調整してください。Cursor Tab 補完は、このカスタム接続先を使いません。

応答が遅いです

対応するチャットリクエストでは、軽量なモデルを試し、選択範囲を絞り、大量の貼り付けより @file の参照を優先してください。

カスタムキーの対象は Cursor の独自 API キーのガイドに記載されています。モデルの呼び出し経路が変更された場合は再確認してください。

サポート

ダッシュボードからチケットを作成し、失敗したレスポンスの request_id を添えてください。