> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# Cursor で BeatAPI を使う

> Cursor の対応チャットリクエストに BeatAPI を設定し、Cursor Tab との違いを確認します。

# Cursor で BeatAPI を使う

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

## 前提条件

1. **Cursor がインストールされていること。**
2. **BeatAPI API キー。** [ダッシュボード → API キー](https://beatapi.io/dashboard/apikeys)で作成します。

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

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

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

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

| 設定       | 値                           |
| -------- | --------------------------- |
| API Key  | BeatAPI API キー              |
| Base URL | `https://api.beatapi.io/v1` |

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

> **Note**
>
> 上記のとおり `https://api.beatapi.io/v1` を指定してください。余分なエンドポイントのパスを付けると誤った URL に送信される場合があります。テストが失敗したらリクエストと BeatAPI の利用状況を確認してください。

> **Note**
>
> OpenAI のベース URL を上書きすると、Cursor の組み込みモデルにも影響する場合があります。Cursor が管理するモデルに戻すときは無効にしてください。[Cursor スタッフの説明](https://forum.cursor.com/t/include-openrouter-support-within-api-keys-supported-services/5347/10)を参照し、両方の経路を併用する前に最新の動作を確認してください。

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

Cursor は独自のモデル一覧を持ちます。一覧にあるだけでは、カスタムキーで利用できるとは限りません。Cursor の [独自 API キーのガイド](https://prod.cursor.com/help/models-and-usage/api-keys)では、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 キー](https://beatapi.io/dashboard/apikeys)でキーが有効か確認します。
3. 社内プロキシを使う場合は `api.beatapi.io` への通信を許可します。

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

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

### 402 insufficient\_credits

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

### 429 rate\_limit\_exceeded

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

### 応答が遅いです

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

カスタムキーの対象は Cursor の[独自 API キーのガイド](https://prod.cursor.com/help/models-and-usage/api-keys)に記載されています。モデルの呼び出し経路が変更された場合は再確認してください。

## サポート

[ダッシュボード](https://beatapi.io/dashboard)からチケットを作成し、失敗したレスポンスの `request_id` を添えてください。