CursorでKimiスタイルのAPIキーを使用する方法:セットアップガイド
Cursorは任意のOpenAI互換エンドポイントと通信できるため、このAPIへの接続には4つのフィールドと約2分かかります。このガイドでは、正確な値、キーが機能することを確認するテスト、および最も遭遇しやすいエラーについて説明します。
更新日:

主要ポイント
- Cursorには3つの値が必要です:あなたのキー、ベースURL https://api.kimiapikey.com/v1、およびモデル名
uncensored。 - まずcurlでキーをテストし、Cursor側の問題とAPI側の問題を簡単に区別できるようにしてください。
- エージェント形式の編集では大きなプロンプトが送信されるため、入力トークンに注意してください:入力1Mあたり$0.15、出力1Mあたり$0.50です。
- 試用キーは同時2リクエストまで許可しますが、Cursorのエージェントはこれを超える可能性があります。フルキーは同時8リクエストまで許可します。
短い答え
CursorでKimi APIキーをどのように使用するかをお探しの場合、まず知っておくべきことは、他のプロバイダが発行したキーは、そのプロバイダ固有のエンドポイントでのみ機能するという点です。このサイトから発行されたキーはこのサイトのエンドポイントで動作し、CursorはエンドポイントがOpenAIのチャット補完フォーマットに対応しているため、それを受け入れます。キーを貼り付け、Cursorを別のベースURLに向け、カスタムモデル名を1つ追加します。
セットアップの全手順:
- アカウントを作成し、APIキーページからキーをコピーしてください。
- Cursorを開き、設定、次にモデルに移動します。
- キーをOpenAI APIキーフィールドに貼り付けます。
- ベースURLの上書きを有効にし、
https://api.kimiapikey.com/v1を入力します。 uncensoredというカスタムモデルを追加し、チャットで選択してください。
この記事の残りの部分では、各ステップを説明し、エディタ外で接続をテストする方法を提供し、一般的に失敗する箇所をリストします。
このキーは何であり、何ではないか
このサイトは、独立したプロバイダによって実行され、合合合法的な成人向け利用においてコンテンツ拒否なしで回答するように調整された1つのオープンウェイトモデルへのアクセスを販売しています。これはMoonshot、Kimi、またはその他のベンダーの公式APIではなく、リクエストを他の人のモデルに転送するルーターでもありません。サイト名はサービスを提供している人ではなく、人々が検索する内容を示しています。すでに他のベンダーからキーをお持ちの場合は、そのベンダーのエンドポイントで使用し続けてください。2つのキーは相互に交換可能ではありません。
提供されるのは標準的なOpenAIスタイルのAPIです:POST /v1/chat/completionsおよびGET /v1/models、ベアートークン認証、100,000トークンのコンテキストウィンドウ、ストリーミング、関数呼び出し、およびJSONモード。テキストのみです。画像生成、埋め込み、ファインチューニングはありません。これらに依存するCursor機能はこのエンドポイントを使用しないため、これはエディタにおいて重要です。Kimi APIキー解説では、命名と代替案についてより詳しく説明しています。
コーディングにおいて「無検閲」には実用的な意味があります。変数名やテストフィクスチャが機密に見えるため、タスクの途中でモデルが停止することはありません。あなたが所有するシステムのセキュリティツール、醜い文字列でいっぱいのログパーサー、スクレイパー、フィクションジェネレーター、およびモデレーションテストセットは、他の場所では拒否を引き起こす種類の作業です。ハードリミットは維持されます:未成年者を含む性的コンテンツは、常に拒否されます。
Cursorでのステップバイステップセットアップ
1. キーと試用クレジットを取得
Googleまたはメールアドレスとパスワードでサインアップします。APIキーページで、ワンクリックで$0.50のトライアルクレジットを取得できます。カードは必要なく、7日間有効で、1人1回限りの特典です。これは数百件の通常のチャットリクエストに十分な量であり、お支払いの前にこのガイド全体を終えることができます。
2. モデル設定を開く
Cursorで設定を開き、モデルセクションを見つけます。メニューラベルはバージョンによって移動するため、OpenAI APIキーの名前が付いたフィールドと、OpenAIベースURLの上書きに関するトグルまたはフィールドを探してください。これらが重要な2つの設定です。
3. 3つの値を入力
| Cursorフィールド | 内容 |
|---|---|
| OpenAI APIキー | ダッシュボードからのキー |
| OpenAIベースURLの上書き | https://api.kimiapikey.com/v1 |
| カスタムモデル名 | uncensored |
表示通りベースURLを入力してください。末尾は/v1で、末尾スラッシュなし、/chat/completionsなしです。クライアントがパスを追加するためです。フルパスを貼り付けると404エラーになり、エラーメッセージで理由が示されることはほとんどありません。
4. モデルを選択しメッセージを送信
チャットパネルを開き、モデルリストからuncensoredを選択し、「ISO日付を解析する関数を書く」など小さなことを尋ねてください。返信がストリーミングで表示されれば完了です。Cursorがエラーを表示する場合、設定をやみくもに変更しないでください。次のセクションに進み、エンドポイントを直接テストしてください。
5. 上書きの副作用を知る
ベースURLの上書きは、通常、Cursorで使用するすべてのOpenAIスタイルのモデルに適用され、カスタムモデルだけでなく適用されます。後で標準的なOpenAIモデルに戻す場合は、まず上書きをオフにしてください。そうしないと、そのモデルが処理できないモデル名でこのエンドポイントにリクエストが送信されます。
エディタを責める前にキーをテスト
ターミナルで2分費やすことで、1時間の推測が節約できます。このリクエストはCursorが行うことと同じこと、つまりベアートークンでチャット補完リクエストを送信します。
curl https://api.kimiapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Reply with the word ready."}],
"max_tokens": 20
}'
choices配列を含むJSONボディは、キー、URL、およびモデル名がすべて正しいことを意味します。レスポンスヘッダーも確認してください。X-Balance-USDは残高クレジットを示し、X-Request-Idはリクエストを追跡する必要がある場合に保持する価値があります。
公式OpenAI SDKを使用したPythonでの同じチェック:
from openai import OpenAI
client = OpenAI(
base_url="https://api.kimiapikey.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Reply with the word ready."}],
max_tokens=20,
)
print(resp.choices[0].message.content)
GET /v1/modelsでモデルを一覧表示することもできます。Cursorや類似のクライアントは、検証ボタンを押す際にこれを呼び出すことがあるため、モデル呼び出しが機能することは良い兆候です。curlが動作してCursorが動作しない場合、問題はエディタ設定にあり、以下のエラー表で一般的なものをカバーしています。
モデルがエディタでコードを書くときの変化
サイドパネルでのチャットは安価です。コンテキストが数百トークン程度の短い質問であれば、1セント未満の費用で済みます。ファイル、検索結果、会話履歴を添付するエディタ機能はより高価になります。なぜなら、すべてのリクエストでそれらすべてが再び送信されるからです。モデルはプロンプトと返信で共有される100,000トークンのコンテキストウィンドウを持ち、大きなフォルダを添付すると、Cursorはその大部分を喜んで埋めます。
実際の計算を示します。リクエストが40,000の入力トークンを含み、モデルが1,500トークンを返信すると仮定します:
- 入力:40,000 / 1,000,000 x $0.15 = $0.006
- 出力:1,500 / 1,000,000 x $0.50 = $0.00075
- 合計:リクエストあたり$0.00675、したがって100回のそのようなリクエストは$0.675かかります
これはヘビーに使った午後でも$1未満ですが、入力が支配的であるため、お金を節約する習慣は短い質問ではなくファイルを少なく付加することです。トピックが変わったら新しいチャットを開始してください。古い履歴は、各ターンで再び支払われるためです。
関数呼び出しはAPIによってサポートされており、エージェントスタイルのエディタ機能の基盤です。モデルはツールを呼び出すことを決定し、クライアントはそれを実行し、結果をrole: "tool"メッセージとして返します。モデルがマルチステップエージェントをどの程度駆動できるかはモデルに依存するため、リファクタリングを任せる前に小さなタスクで試してください。APIの背後にある1つのオープンウェイトモデルは、メニューから選択できるのではなく、1つの動作しか提供しないことを意味します。
Cursorのタブ補完などのCursor独自のモデルで動作するCursor機能は、通常、カスタムキーによって切り替えられません。どの機能がカスタムOpenAIスタイルエンドポイントを受け入れるかについては、Cursorの現在のドキュメントを確認してください。このリストはリリース間で変化するためです。
一般的なエラーとその修正方法
| 症状 | 考えられる原因 | 修正方法 |
|---|---|---|
| 404または「見つかりません」 | ベースURLにエンドポイントパスが含まれている、または/v1がない | 正確にhttps://api.kimiapikey.com/v1を使用してください |
| 401 認証エラー | 貼り付けたキーに余分なスペースや改行が含まれているか、古いキーです | ダッシュボードからキーを再コピーし、再度貼り付けてください |
| モデルが見つからない | モデル名の入力ミス | uncensoredを使用してください。小文字で、それ以外は何も入れないでください |
コード concurrency の 429 エラー | キーに対して一度にリクエストが多すぎます | 実行中のリクエストが完了するまで待つか、フルキー(同時実行8件)を使用してください |
コード rate_limited の 429 エラー | 1分あたりの制限を超えています | リクエスト速度を落としてください。トライアルキーは1分あたり60件、フルキーは300件まで許可されます |
Retry-After: 5 ヘッダー付きの 429 エラー | 一時的な過負荷 | 5秒後に再試行する |
| 検証ボタンは失敗するが、curl は動作する | エディターは自分が知っているモデル名でテストを行います | 検証ステップをスキップして、実際のチャットメッセージを送信します |
同時実行エラーはトライアルキーを使用しているユーザーを驚かせるため、注記が必要です。トライアルキーでは同時実行リクエストが2件まで許可され、エージェントが複数の操作を並列に開始すると、ユーザーの操作の有無にかかわらずその制限を超えてしまうことがあります。ストリーミングレスポンスもストリーミングが終了するまでスロットを保持するため、長い回答はスロットを占有し続けます。フルキーでは同時実行リクエストが8件、1分あたりのリクエストが300件まで許可され、1人の開発者にとって十分な性能です。
失敗したリクエストと拒否されたリクエストには課金されないため、エラー後に再試行しても追加料金はかかりません。完全な制限については ドキュメントページ を参照してください。
トライアルクレジットが尽きた後に支払いを行う
サブスクリプションはありません。$20〜$500の任意の整数金額で前払いクレジットをチャージでき、リクエストは入力トークン100万トークンあたり$0.15、出力トークン100万トークンあたり$0.50でクレジットを減らします。クレジットは期限切れにならないため、コーディングをしない月はコストゼロです。$50以上のチャージにはボーナスが付きます:$50で+5%、$100で+10%、$200で+15%。暗号資産(TRC20上のUSDT、Base上のUSDC)でお支払いいただけます。価格ページに現在の数値がまとめて記載されています。
前述の40,000入力・1,500出力のリクエストを使用した場合、$20のチャージで約2,960件の同種のリクエストをカバーできます($20 / $0.00675)。ほとんどのエディタリクエストはこれより小さいため、実際の対応可能なリクエスト数はさらに多くなります。プロンプトは学習に使用されないため、貼り付けたコードがクライアントの所有物である場合に重要です。
セットアップ完了後、最初に推奨されるのは、素早く確認できる小さなタスクです。既存の関数のユニットテスト、長いコメント付きの正規表現、またはノイズの多いファイルの書き換えなどが該当します。結果がワークフローに合えばクレジットを追加してください。合わなければ、無料トライアルクレジットのわずかな金額で確認できたことになります。
その他のガイド
よくある質問
モデルはMoonshotの公式Kimiと同じですか?
いいえ、当社は無検閲に調整されたオープンウェイトモデルをホストしています。GPT、Claude、Gemini、Grok、DeepSeek、またはその他のベンダーのモデルではありません。独自のサーバーで実行される独自のモデルです。
データを学習に使用しますか?
いいえ。プロンプトや生成結果は学習に使用されません。プライバシーと透明性を重視しており、データはあなたのものです。
レート制限は何ですか?
キーごとに1分あたり300リクエストが制限されます。最大リクエストボディサイズは8 MBです。これらの制限は、すべてのユーザーに安定したパフォーマンスを提供するために設計されています。
コンテンツポリシーは?
モデルは大人向け、論争的、クリエイティブなトピックについて無検閲です。ただし、未成年者を含む性的コンテンツはブロックされます。これはサブスクリプションレベルに関係なく常に適用される厳格な制限です。
質問と回答
このベースURLでMoonshotまたはKimiのAPIキーをCursorに設定できますか?
いいえ。キーは、発行元のプロバイダーのエンドポイントでのみ機能します。ダッシュボードのキーをここで使用するか、別のキーをそのプロバイダーの URL とともに維持してください。
Cursor にはどのモデル名を入力しますか?
小文字の uncensored を入力してください。これがこの API が提供する唯一のモデル ID であり、異なる名前を入力するとモデルが見つからないエラーが返されます。
Cursor のエージェントモードで動作しますか?
API はエージェント機能に必要なツール呼び出しをサポートしています。モデルが長いマルチステップタスクをどの程度確実に完了できるかは異なるため、大きなタスクの前に小さなタスクでテストしてください。
トライアルキーで 429 エラーが発生するのはなぜですか?
トライアルキーは同時実行リクエストが2件、1分あたり60件まで許可されます。フルキーは同時実行8件、1分あたり300件まで許可され、Retry-After: 5 ヘッダーは短時間の過負荷を示し、再試行可能です。
私のコードは学習に使用されますか?
いいえ。APIに送信されたプロンプトは学習には使用されません。
キーはフォーム 1 つで手に入ります
アカウントを作成し、キーをコピーし、ベースURLを変更します。これでセットアップは完了です。