GitHub Copilot API キーのCursor APIでの使用方法

APIキーの互換性の理解

開発者がgithub copilot api keyについて言及する場合、通常はMicrosoft GitHubエコシステム内で生成されたトークンを指します。このキーはMicrosoftのサーバーへのリクエストを認証し、GPT-4oやコード最適化された特殊なバリエーションなどのモデルを実行します。これらのモデルは強力ですが、Microsoftアカウントに紐付いた特定のコンテンツフィルタとレート制限があります。

対照的に、Cursor APIは独立したサービスとして機能します。Microsoftのインフラストラクチャに依存しません。代わりに、コーディングコンテキスト向けに最適化された単一のオープンウェイト大規模言語モデルを提供します。このモデルは、法的な成人用途に対してコンテンツ拒否なしで回答するように設計されており、標準的なフィルタが制限的だと感じる開発者にとって明確な代替手段となります。

この区別を理解することが重要です。既存のGitHub Copilot APIキーはCursor APIのエンドポイントでは機能しません。cursorapikey.comのアカウントから別のキーを生成する必要があります。ただし、基盤となるプロトコルは同じなので、コードを大幅に変更する必要はありません。

環境の設定

Cursor API を利用するには、まず API キーを生成する必要があります。メールアドレスとパスワードだけで、API キーを取得ページにサインアップしてください。初期のトライアルクレジットにはクレジットカードは不要です。登録完了後、キーが即座に表示されます。このキーはエージェントの要件に応じて通常は OPENAI_API_KEY やカスタム変数として環境変数に安全に保存してください。

Cursorや類似のツールを含むほとんどのコーディングエージェントは、OpenAI SDK標準に依存しています。つまり、カスタムライブラリは不要です。SDKを正しいベースURLにポイントするだけで済みます。Cursor APIのベースURLはhttps://api.cursorapikey.com/v1です。このエンドポイントは完全にOpenAI互換で、すでに慣れ親しんでいるのと同じリクエスト構造をサポートしています。

環境が新しいベースURLにリクエストを送信するように設定されていることを確認してください。リクエストで指定する必要があるモデルIDはuncensoredです。これは、APIに特定のモデルを呼び出すよう指示します。これはGPT、Claude、またはGeminiとは異なる、独自のGPUサーバーで実行されるオープンウェイトモデルです。

ベースURLの変更

github copilot api keyからCursor APIへの切り替えは、主にクライアント設定のベースURLを変更することです。公式のOpenAI PythonまたはNode.js SDKを使用している場合、これは1行の変更で済みます。例えば、Pythonでは、新しいベースURLと新しいAPIキーを使用してクライアントを初期化します。

この変更により、リクエストはMicrosoftのサーバーから当社のインフラストラクチャにリダイレクトされます。メリットには、100,000トークンのコンテキストウィンドウへのアクセスと、拒否が少ないようにチューニングされたモデルが含まれます。/v1/modelsエンドポイントを確認することで接続を確認できます。これにはuncensoredを含む利用可能なモデルが返されます。

トレードオフ： 構文は同一ですが、Microsoft のサブスクリプションではなく、トークン単位で課金されます。当社の価格は透明です：入力トークン 100 万トークンあたり $0.25、出力トークン 100 万トークンあたり $1.00。月額料金はなく、期限のない従量課金制のクレジットのみです。このモデルは、月額分の席料にコミットしたくない可変ワークロードに最適です。

接続のテスト

APIをメインのワークフローに統合する前に、環境がCursor APIと通信できることを確認することが重要です。これは簡単なcURLコマンドまたは短いスクリプトで実行できます。このテストにより、キーが有効でベースURLが正しいことが確認されます。

cURLリクエストの例：

モデルをuncensoredに設定してhttps://api.cursorapikey.com/v1/chat/completionsにPOSTリクエストを送信します。messages配列に簡単なプロンプトを含めます。成功したレスポンスは、choices[0].message.contentフィールドに補完を返します。

401エラーが返された場合、APIキーが間違っています。429エラーが返された場合、キーあたりの1分あたりの300リクエストのレート制限を超えています。古いキーを無効化するためにいつでもキーを再生成できます。このテストにより、基本的なテキスト入力・テキスト出力機能が期待どおりに動作していることが確認されます。

ストリーミングレスポンスの処理

コーディングエージェントにとって、ストリーミングレスポンスはスムーズなユーザー体験を提供するために重要です。Cursor APIはストリーミングのためにServer-Sent Events (SSE)をサポートしています。これにより、完全なレスポンスを待つことなく、トークンが生成されるたびに受信できます。

OpenAI SDK を使用する場合、stream パラメータを true に設定することでストリーミングを有効にできます。SDK はデータが受信されるたびにチャンクを返します。これは、ユーザーに進捗状況を表示したり、ライブエディタにトークンを供給したりしたい長時間のコード生成において特に有用です。

ストリーミングは基盤となるモデルやその機能を変更するわけではありません。これは純粋な配信メカニズムです。uncensoredモデルは、100,000トークンのコンテキストウィンドウと同じ料金構造に従い続けます。ストリーミングは知覚されるレイテンシーを改善するクライアント側の機能であり、モデルの動作には影響しません。

ツール呼び出しの統合

最新のAIコーディングアシスタントは、シェルのコマンド実行やファイルへのアクセスなど、外部世界と対話するためにツール呼び出し（関数呼び出し）に大きく依存しています。Cursor APIは標準のOpenAI互換形式を介してこれをサポートしています。

リクエストでtoolsパラメータを使用してツールを定義できます。モデルはツールを使用すべきと判断した場合、tool_calls配列で応答します。アプリケーションはその後、ツールを実行し、結果を後続のメッセージでAPIに送信する必要があります。

このプロセスは、Microsoftのモデルでgithub copilot api keyを使用する場合と同じです。ここでは一貫性が利点です。ツール呼び出しの既存コードがある場合、最小限の調整で再利用できる可能性があります。ツール定義がuncensoredモデルの期待されるスキーマに一致していることを確認してください。

使用状況の監視

トークンごとに課金されるため、予期せぬコストを避けるために使用状況を監視することが重要です。Cursor APIは、クレジット残高と使用履歴を表示できるダッシュボードを提供します。消費したトークン数と残っているクレジットの量を確認できます。

注意すべき主要な制限：

• レート制限：キーあたり1分あたり300リクエスト。
• リクエストボディサイズ：リクエストあたり最大8 MB。
• コンテキストウィンドウ：合計100,000トークン（入力＋出力）。

レート制限を超えた場合、429エラーが返されます。これらの範囲内に留まることを確認するためにリアルタイムで使用状況を監視できます。また、キーが侵害されたと思われる場合はAPIキーを再生成でき、古いキーは直ちに無効化されます。

一般的な問題のトラブルシューティング

堅牢なAPIであっても、問題が発生する場合があります。以下に一般的な問題とその解決策を示します。

401 Unauthorized（認証エラー）： APIキーを確認してください。コピーが正しく、前後にスペースがないことを確認してください。キーを再生成した場合は、新しいキーを使用していることを確認してください。

429 Too Many Requests（リクエスト数多すぎ）： 1分あたりの300リクエストの制限を超えました。クライアントで指数関数的バックオフを実装するか、リクエストの頻度を減らしてください。

400 Bad Request（不正なリクエスト）： これは通常、不正なJSONペイロードまたは必須フィールドの不足を示します。messages配列が正しくフォーマットされ、roleとcontentフィールドを含んでいることを確認してください。また、モデル名が正確にuncensoredであることを確認してください。

コンテンツブロック： このモデルは無検閲ですが、未成年者を含む性的コンテンツはブロックされます。リクエストがブロックされた場合、これは特定のハード制限によるものかもしれません。