Moonshot API Base URL:コードの送信先を変更
moonshot APIのBase URLはOpenAI互換クライアント内の単なる文字列であり、それを変更することで同じコードを別のプロバイダに接続できます。このページでは、その文字列がPython、Node.js、curl、および一般的なツール内でどこに位置するか、および代替エンドポイントに接続する方法を示します。
更新日:


主要ポイント
- base URLは単一の設定であり、リクエストボディはOpenAIチャット形式のままです。
- 切り替える際に変更する必要があるのは3つ:base URL、API キー、モデルID。
- 当社のエンドポイントはhttps://api.kimiapikey.com/v1であり、モデルIDはuncensoredです。
- これは独立したホストモデルでありMoonshotの公式サービスではないため、プロンプトを再テストしてください。
base URLの実際の役割
OpenAI互換クライアントは、ベースURLとパスという2つの部分からすべてのリクエストを構築します。SDKはこれらを結合するため、chat.completions.createへの呼び出しは、<base_url>/chat/completionsへのPOSTになります。この形式に従うプロバイダ(Moonshotを含む)は、独自のベースURLをドキュメントで公開しています。フォーラムの投稿からコピーするのではなく、ドキュメントの中で検索して確認してください。これは推測できない唯一の値だからです。
したがって、プロバイダの切り替えには3つの編集のみが必要です。
- リクエストの送信先を決定するbase URL。
- プロバイダごとに発行され、そのプロバイダのサーバーでのみ機能するAPI キー。
- モデルID。各プロバイダはモデルに異なる名前を付けているため。
メッセージ、ロール、ストリーミング、ツール、JSONモードは同じ構造を維持するため、移行は短時間で済みます。組み込みのウェブ検索ツールなど、プロバイダ固有の機能に依存するものは別途処理が必要です。
また、3つの値をプロバイダごとに1つの設定ブロックまたは環境ファイルにまとめて保持すると便利です。base URL、キー、モデルIDが並んでいる場合、切り替えは1行の変更で済み、新しいキーが古いアドレスとペアになる中途半端な移行状態を避けることができます。
Python: openaiパッケージ
Pythonでは、クライアント作成時にbase URLを設定します。この例では当サイトのエンドポイントに接続します。
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": "Explain a base URL in one sentence."}],
)
print(resp.choices[0].message.content)
コードに設定を記述したくない場合は、環境変数を使用してください。SDKは引数なしでOpenAI()を呼び出す際に、OPENAI_BASE_URLとOPENAI_API_KEYを読み取ります。これにより、コードの変更なしでデプロイ時にプロバイダを切り替えることができます。ただし、シェルの残存変数がファイルに記述した値を上書きする可能性がある点にご注意ください。
Nodeとcurl
公式JavaScriptパッケージも同じオプション名(キャメルケース)を使用します。
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.kimiapikey.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Hello" }],
stream: false,
});
console.log(resp.choices[0].message.content);
SDKを全く使用しない場合、base URLは単にアドレスの先頭部分です。
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":"Hello"}]}'
同じエンドポイントはPOST /v1/responsesも受け付け、GET /v1/modelsは提供されているモデルを一覧表示します。認証は、すべてのケースでAuthorizationヘッダー内のベアートークンです。
エディタとチャットフロントエンド
GUIツールは異なるラベルでbase URLを公開します:「API base」、「Override OpenAI Base URL」、「Custom endpoint」、「Provider URL」など。貼り付ける値は上記のコードと同じ文字列で、/v1で終わります。ツールが完全なURLを必要としていると言わない限り、完全な/chat/completionsアドレスを貼り付けないでください。
保存後、ツールがリストを取得しない場合はモデルIDを手動で追加してください。一部のエディタはキーを固定されたプロバイダに対して検証し、カスタム値を拒否することがあります。その場合は、まずカスタムまたはOpenAI互換モードを有効にする設定を探してください。CursorでKimiスタイルのAPIキーを使用するに関する記事で、そのようなツールの詳細な手順を解説しています。
プロバイダを切り替えた際の変更点
形式が一致しても、動作が一致するとは限りません。本番トラフィックを移動する前に、以下の項目を一つずつ確認してください。
- 出力スタイル。 モデルによって書き方が異なります。お手本ではなく、実際のプロンプトで実行してください。
- コンテキストウィンドウのサイズ。 このエンドポイントは、プロンプトと補完を合わせて100,000トークンのウィンドウを持っています。現在の設定でより長いプロンプトを送信する場合は、まずトリミングしてください。
- 制限。 完全なキーでは8つの同時リクエストと1分あたり300リクエストが許可されます。いずれかの制限を超えると、HTTP 429エラーが発生し、コードは
rate_limitedまたはconcurrencyになります。 - 機能。 SSEを介したストリーミング、ツール呼び出し、JSONモードはサポートされています。画像、音声、動画の生成、埋め込み、ファインチューニングは行われません。これはテキスト専用のAPIです。
- 命名。 このサービスは、法的な成人利用においてコンテンツフィルタリングなしで回答するために選ばれた1つのオープンウェイトモデルを実行します。これはMoonshot公式のAPIではなく、ベンダー間のルーターでもありません。
比較するための中立な方法は、同じ10個のプロンプトを両方のエンドポイントでログに記録し、回答を並べて読むことです。これには数分かかり、推測を省くことができます。
ベースURLの間違いとその外観
切り替え後のほとんどの失敗は、キーではなくアドレスに起因します。各ミスの発生方法と修正方法を以下に示します。
| ミス | 症状 | 修正方法 |
|---|---|---|
ホストのみ、/v1なし | すべての呼び出しで404 | 末尾に/v1を追加 |
| 完全なパスが貼り付けられた | エラーにパスが重複して表示される404 | アドレスを/v1に戻す |
| 末尾のスラッシュと手動パス結合 | URL内の二重スラッシュ | SDKにパス結合を任せる |
| 古いキー、新しいURL | 401 | 新しいプロバイダが発行したキーを使用する |
| 古いURL、新しいキー | 古いプロバイダからの401 | リポジトリとシェルで古いアドレスを検索する |
http://ではなくhttps:// | リダイレクトまたは接続エラー | すべてでhttpsを使用する |
残存物を素早く見つけるには、プロジェクトとデプロイ設定で古いホスト名を検索します。.envファイル、CI変数、Docker composeファイル、およびすべてのエディタ設定を確認してください。1つの見落としでも、トラフィックの一部を古いプロバイダに送信する原因になります。
切り替え後のストリーミングとツール
stream: trueを設定すると、レスポンスはサーバー送信イベントとして到着し、トークン使用量は最後に報告されます。ツール呼び出しは通常のtoolsとtool_choiceフィールドを使用し、ストリーミングされるtool_callsと結果は、role: "tool"を含むメッセージとして送り返されます。コードが古いプロバイダに対してこれらをすでに処理している場合、そのまま動作し続けるはずです。完全に切り替える前に、ストリーミング呼び出しとツール呼び出しを1回ずつ実行して確認してください。ストリーミングリクエストは、ストリームが終了するまで同時実行スロットを保持することに注意してください。
切り替え前のコスト確認
ここでの請求はトークン単位です:入力トークン100万あたり$0.15、出力トークン100万あたり$0.50で、前払いクレジットから引かれます。サブスクリプションはありません。失敗または拒否されたリクエストは課金されず、クレジットは期限切れになりません。他のプロバイダの料金は変動するため、現在の料金ページをご確認ください。
具体的な例。リクエストが入力トークン2,000、出力トークン500の場合:
- 入力: 2,000 / 1,000,000 x $0.15 = $0.0003
- 出力: 500 / 1,000,000 x $0.50 = $0.00025
- 合計: 1 リクエストあたり $0.00055。したがって 1,000 リクエストで $0.55 です
最小チャージ額は $20 で、大口チャージにはボーナスが付きます: $50 で +5%、$100 で +10%、$200 で +15%。暗号資産(TRC20 上の USDT、Base 上の USDC)が利用可能です。詳細は 料金ページ、Kimi 特化の内訳は Kimi API キーの料金をご覧ください。
キーを取得して最初の呼び出しを実行する
Google またはメールアドレスとパスワードでサインアップし、API キーページを開きます。新規ユーザーはワンクリックで $0.50 の無料トライアルクレジットを付与できます(1 人 1 回、有効期限 7 日、カード不要)。トライアルキーは同時 2 リクエスト、1 分あたり 60 リクエストに制限されていますが、テスト実行には十分です。
キーを上記の Python スニペットに貼り付けて実行し、テキストが返ってくることを確認してください。ドキュメントにはすべてのパラメータが記載されており、レスポンスヘッダー X-Request-Id と X-Balance-USD はデバッグと残高追跡に役立ちます。サービスに送信されたプロンプトは学習に使用されません。
その他のガイド
よくある質問
モデルはMoonshotの公式Kimiと同じですか?
いいえ、当社は無検閲に調整されたオープンウェイトモデルをホストしています。GPT、Claude、Gemini、Grok、DeepSeek、またはその他のベンダーのモデルではありません。独自のサーバーで実行される独自のモデルです。
データを学習に使用しますか?
いいえ。プロンプトや生成結果は学習に使用されません。プライバシーと透明性を重視しており、データはあなたのものです。
レート制限はどのくらいですか?
キーごとに1分あたり300リクエストに制限されます。リクエストボディの最大サイズは8 MBです。これらの制限は、すべてのユーザーに安定したパフォーマンスを提供するために設計されています。
コンテンツポリシーは?
モデルは大人向け、論争的、クリエイティブなトピックについて無検閲です。ただし、未成年者を含む性的コンテンツはブロックされます。これはサブスクリプションレベルに関係なく常に適用される厳格な制限です。
質問と回答
Base URL を変更したときにコードを変更する必要がありますか?
通常は 3 つの値のみです: Base URL、API キー、モデル ID。メッセージ形式、ストリーミング、関数呼び出しは、新しいプロバイダーがそれらをサポートしている限り同じままです。
Base URL は /v1 で終わる必要がありますか?
このエンドポイントでははい:https://api.kimiapikey.com/v1. SDKは/chat/completionsを自動で付加するため、含めないでください。
これは公式の Moonshot API ですか?
いいえ。これは OpenAI 互換 API を介して提供される独立したホスト型オープンウェイトモデルです。Moonshot のサービスではなく、ベンダー間のルーターでもありません。
モデル ID はどこで確認できますか?
キーを使用して GET /v1/models を呼び出します。このエンドポイントではモデル ID は uncensored です。
キーはフォーム 1 つで手に入ります
アカウントを作成し、キーをコピーし、ベースURLを変更します。これでセットアップは完了です。