JA ▾
APIキーを取得

cursorapikey.com/ガイド

カスタムエンドポイントでCursor APIキーを使用する方法

独自のエンドポイントでCursor API設定を使用する方法:キーを貼り付け、OpenAIのベースURLを上書きし、モデル名uncensoredを追加します。以下の手順は約5分かかり、最初に実行できるcurlチェックが含まれています。

更新日:

カスタムAPIエンドポイントを視覚化した、サーバーキューブに光るケーブルで接続されたアイソメトリックコードエディタ

主要ポイント

  • CursorはOpenAIベースURLとキーを上書きできるため、OpenAI互換エンドポイントがリクエストを処理できます。
  • ベースURL https://api.cursorapikey.com/v1とモデルID uncensoredを使用してください。
  • エディタをいじる前にcurlでキーをテストし、障害の原因がどちら側にあるかを確認してください。
  • 20,000トークンのプロンプトと1,000トークンの回答で、料金は$0.0035です。

このガイドでカバーする内容

Cursor APIの使用方法を検索する人は、通常2つの意味のどちらかを指します。コードからCursorサービスを呼び出したいのか、それともCursorエディタがモデルリクエストを自分で選んだエンドポイントに送信してほしいのかです。このガイドは後者のケースに関するものです。このサイトはOpenAIのチャット補完プロトコルに対応する独立したホスト型APIであり、CursorはOpenAIスタイルのサーバーと同様にこれと通信できます。

その背後にあるモデルは単一のオープンウェイトモデルで、独立したプロバイダによって実行され、合法的な成人の利用においてコンテンツ拒否なしで回答するようにチューニングされています。これは公式のCursorモデルではなく、ベンダー間のルーターでもありません。テキストのみを処理します。コーディングには通常これで十分です:コードと指示を送信すると、コードと解説が返ってきます。

必要なものは3つです:APIキー、ベースURL https://api.cursorapikey.com/v1、およびモデルID uncensored。あとはエディタ内の適切なフィールドを見つけるだけです。

ステップ1:キーを取得しcurlで確認する

Googleまたはメールアドレスとパスワードでサインアップし、APIキーページを開きます。新規アカウントはワンクリックで$0.50の無料トライアルクレジットを受け取ることができます。クレジットカードは不要で、7日間有効です。トライアルキーは2つの同時リクエストと1分あたり60リクエストに制限されており、エディタでの最初のセッションには十分です。

Cursorを開く前に、キーが機能することを確認してください。環境変数にキーを設定してターミナルでこれを実行します:

export API_KEY="paste-your-key-here"

curl https://api.cursorapikey.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

curl https://api.cursorapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "user", "content": "Write a Python function that reverses a linked list."}
    ]
  }'

最初の呼び出しでモデルがリストされます。2回目の呼び出しで通常のチャット補完が返されます。両方が成功した場合、エディタ内のその後の失敗はキーの問題ではなく設定の問題です。この分離により、推測の量が大幅に減ります。

ステップ2:CursorでベースURLとキーを設定する

Cursorの設定を開き、モデルセクションに移動します。メニュー名とレイアウトはリリースによって変更されるため、以下のラベルをマップとして扱い、移動した場合はCursor自身のドキュメントを確認してください。

  1. OpenAI APIキーのフィールドを見つけ、このサイトからのキーを貼り付けます。
  2. OpenAIベースURLの上書きオプションを有効にし、https://api.cursorapikey.com/v1を入力します。末尾に/v1を保持し、/chat/completionsを追加しないでください。クライアントアプリがパスを自動的に付加します。
  3. カスタムモデルを追加し、小文字のuncensoredを正確に入力します。
  4. エディタに確認または保存ボタンがある場合はそれを使用し、チャットパネルで新しいモデルを選択します。

ファイルを開いた状態で「この関数を説明してください」などの短いメッセージを送信します。ストリーミングされた回答は、ルートがエンドツーエンドで機能していることを意味します。Cursorはリクエストを送信し、エンドポイントはSSEを介してトークンをストリーミングし、エディタは到着順にレンダリングします。

2つの注意。インラインタブ補完などのエディタ機能は、Cursorが制御するモデルで実行され、キーを無視する可能性があるため、実際にカスタムモデルを使用する機能を確認してください。また、Cursorがカスタムキーのトラフィックを独自のサーバー経由でルーティングする可能性があるため、コードが正確にどこを通過するかを知る必要がある場合は、最新のドキュメントをお読みください。このサイトのクイックスタートにはAPI側の契約が記載されています。

コードから同じエンドポイントをテストする

問題を分離する最も簡単な方法は、公式OpenAI SDKを使用してエンドポイントを呼び出すことです。これが機能すればエンドポイントは正常であり、残りの問題はエディタ設定にあります。

from openai import OpenAI

client = OpenAI(
    api_key="paste-your-key-here",
    base_url="https://api.cursorapikey.com/v1",
)

stream = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You are a terse senior engineer."},
        {"role": "user", "content": "Refactor this loop into a list comprehension: out = []\nfor x in xs:\n    if x > 0:\n        out.append(x * 2)"},
    ],
    stream=True,
)

for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

Nodeでの同じ操作:

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.API_KEY,
  baseURL: "https://api.cursorapikey.com/v1",
});

const res = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Write a regex that matches ISO 8601 dates." }],
});

console.log(res.choices[0].message.content);

ストリーミングレスポンスの末尾には使用状況が含まれるため、リクエストで何トークン使用したかを正確にログに記録できます。各レスポンスには、残高クレジットを示すX-Balance-USDヘッダーと、何かが正しくない場合に引用できるX-Request-Idも含まれます。

コーディングワークフローで機能すること

APIはストリーミング、JSONモード、ツール呼び出し(tools、tool_choice、ストリーミングされたtool_calls、およびrole: "tool"として返される結果)をサポートしています。temperature、top_p、stop、seedなどのサンプリング設定とペナルティは渡されます。コンテキストウィンドウは100,000トークンで、プロンプトと補完で共有され、max_tokensはオプションです。

この100,000トークンはコードにとって十分な予算です。数百行のソースファイルは数千トークン程度であるため、複数のファイルと長い指示を含めても回答の余地が残ります。最大リクエストボディは8 MBで、テキストでは到達しません。

エディタでカスタムモデルを快適に使用するための習慣:

  • コード編集には低いtemperatureを維持してください。0.2前後の値は出力を安定させます;アイデア出しの場合のみ値を上げてください。
  • 必要なファイルのみを添付してください。送信するトークンすべてが入力として請求され、会話全体が各ターンで再送信されます。
  • ファイルが長い場合は、ファイル全体ではなく差分または変更された関数を依頼してください。出力トークンは入力トークンよりも高価です。
  • 拒否が邪魔になるタスクにモデルを使用してください。例えば、自分のラボ用のエクスプロイトPoCの作成、調査許可のあるマルウェアサンプルの分析、不快な実世界のコンテンツを模したテストデータの生成など。すべて法に準拠している必要があります。

繰り返す価値のある1つのハードリミット:どの文脈でも未成年者との性的コンテンツは禁止です。

一般的なエラーの修正

症状考えられる原因修正方法
401または「無効なキー」キーにスペースが含まれている、または古いキーキーページから再コピーし、curlでテスト
404または「モデルが見つかりません」モデル名の入力ミス接尾辞なしの小文字のuncensoredを使用
パスで404ベースURLに/chat/completionsが含まれているベースURLを/v1で終了
429とconcurrency一度にリクエストが多すぎるストリームが終了するまで待ちます。フルキーは8、トライアルキーは2まで許可
429とrate_limited1分あたり300件を超えるリクエスト(トライアルは60)速度を落とすか、一時停止後に再試行
429 と Retry-After: 5一時的な過負荷5秒後に再試行する

ストリーミングリクエストはストリームが終了するまで同時実行スロットを保持します。Cursorで複数のチャットを開始して生成を放置すると、トライアルキーで同時実行数の制限にすぐに達する可能性があります。失敗または拒否されたリクエストは請求されないため、再試行には追加コストがかかりません。

コーディングセッションのコスト

価格は入力トークン1Mあたり$0.15、出力トークン1Mあたり$0.50で、サブスクリプションなしで前払いクレジットから支払われます。典型的なエディタリクエストは大きなプロンプト(ファイル)と短い回答を持ちます。入力トークン20,000と出力トークン1,000の場合:

  • 入力:20,000 x $0.15 / 1,000,000 = $0.0030
  • 出力:1,000 x $0.50 / 1,000,000 = $0.0005
  • 合計:リクエストあたり$0.0035

1日の作業で100リクエストの場合、料金は$0.35です。$0.50のトライアルクレジットでは、このようなリクエストが約140回分カバーされます。トライアル終了後、$20から$500までの任意の整数額をチャージでき、$50以上で+5%、$100以上で+10%、$200以上で+15%のボーナスクレジットが付与されます。暗号資産(TRC20上のUSDT、Base上のUSDC)でお支払いください。クレジットは期限切れにならないため、ゆっくりと使用するチャージは無駄になりません。料金ページに完全な表があり、CursorおよびCopilotの代替のページで、これがサブスクリプションエディタの隣でどこに位置するかを説明しています。

プロンプトはトレーニングに使用されません。

01

質問と回答

これはCursorエージェントや関数呼び出しでも動作しますか?

APIは関数呼び出し、tool_choice、ストリーミングされるtool_callsに対応しています。Cursorの特定の機能がカスタムモデルを使用するかどうかはエディタに依存するため、設定後に各機能をテストしてください。

どのモデル名を入力すればよいですか?

小文字でuncensoredを入力してください。これが唯一のモデルIDであり、GET /v1/modelsで一覧表示されます。

これは公式のCursor APIですか?

いいえ。これは1つのオープンウェイトモデルの前面に設置された独立したOpenAI互換APIです。Cursorは単に、OpenAIの設定を別のエンドポイントに指すようにするだけです。

試すためにカードが必要ですか?

いいえ。$0.50のトライアルクレジットは、サインアップ後にAPIキーページでワンクリックで取得でき、カードは不要で、7日間有効です。

キーはフォーム 1 つで手に入ります

アカウントを作成し、キーをコピーし、ベースURLを変更します。これでセットアップは完了です。