ガイド一覧 / コーディング支援

Cursor で XHuoAPI を使う

Cursor は独自の API キーを使い、OpenAI 形式のリクエストを任意の OpenAI 互換エンドポイントに転送できます。設定項目は API キー・Base URL・モデル ID の3つだけです。

はじめる前に

コンソールで登録し、API トークンを作成します。登録に必要なのはメールアドレスだけで、電話番号は不要です。
トークン作成時にティアを選びます。新規アカウントの既定は Standard です。ティアは価格と安定性、そして利用できるモデルを決めます。詳細は料金ページを参照してください。

まず確認

ツールを設定する前に、curl でキーとモデルが使えることを確認してください。「設定したのに反応がない」の半分はこれで切り分けられます。

curl https://api.xhuoapi.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v3.2","messages":[{"role":"user","content":"ping"}]}'

設定手順

Cmd+Shift+J（macOS）または Ctrl+Shift+J（Windows/Linux）で設定を開き、Models ページの API Keys セクションを探します。

OpenAI API Key 欄に XHuoAPI のキーを入力します。OpenAI のモデルを使わなくても、Cursor は転送先の認証にこの欄を使います。

Override OpenAI Base URL にチェックを入れ、表示された欄に以下の URL を入力します。

https://api.xhuoapi.ai/v1

Models 一覧に戻り Add model でモデル ID（例：deepseek-v4-pro）を手動追加し、チャットのモデル選択で選びます。

注意点

既知の制限：Override を有効にすると、内蔵セレクターで選んだ Cursor サブスクリプションのモデルも含め、OpenAI 系のリクエストがすべて指定エンドポイントに送られます。サブスクのモデルを使うときは一時的に Override を無効にしてください。Cursor チームが現行の動作として確認済みです。

Tab 補完は影響を受けません。常に Cursor 自身のバックエンドを使います。

Base URL は /v1 まで。/chat/completions を付けないでください。クライアントが自動的にパスを付加するため、付けると 404 になります。

モデル ID は料金ページの表記と完全に一致させてください（DeepSeek V4 Pro ではなく deepseek-v4-pro）。大文字小文字とハイフンも区別されます。

よく使われるモデル

この種のツールでよく選ばれるモデルです。モデル名をクリックするとティア別の価格を確認できます。全一覧は料金ページにあります。

deepseek-v4-pro claude-sonnet-5 gpt-6-sol kimi-k2.7-code glm-5.3

手順は各ツールの現行の公式ドキュメントに基づいています。アップデートで UI が変わることがあります。相違があればお知らせください。