Moonshot の動作方法
Moonshot AI は Kimi ファミリーのモデル(K2、K2.5、K2.6、K2.6 Coding)を公開しています。Kimi は長コンテキストのコード理解とエージェントワークフローに特に強く、API は完全に OpenAI 互換です — Kodus は OpenAI-compatible プロバイダーを通じて通信できます。Kodus には専用の Moonshot プロバイダーもあり、Moonshot の Anthropic 互換エンドポイント(https://api.moonshot.ai/anthropic)経由で接続します。
Moonshot は同じモデルファミリーに 2つのパスを提供しており、それぞれ独自のエンドポイントがあります:
- Developer API(
platform.moonshot.ai)— ペイパートークン、使用量ごとに課金。同時実行数はリチャージティアとスケールします。 - Kimi Code Plan(
kimi.com/code)— 専用コーディングエンドポイント付きのサブスクリプション。定額価格、同時実行数は上限付き(30 concurrent)。
Moonshot のコンシューマー Kimi.com チャットサブスクリプション(Andante、Moderato など)は、両方の API パスとは別物です。チャットサブスクリプションは API アクセスを付与しません。Kimi Code Plan が API 専用のサブスクリプションです。
platform.moonshot.cn、ベース URL https://api.moonshot.cn/v1)も運営しており、CNY で課金されます。中国本土内で運営する場合にのみ使用してください。
プランの概要
Kimi Code Plan(サブスクリプション)
Developer API(ペイパートークン)
Developer API エンドポイント:
https://api.moonshot.ai/v1(国際)。同時実行数はリチャージティアとスケール — Tier 1($10 リチャージ)は約50 concurrent から開始し、Tier 5 では最大約1000 concurrent。
APIキーの作成
- Kimi Code Plan サブスクライバー
- Developer API(ペイパートークン)
- kimi.com/code にアクセスしてプランにサブスクライブします。
- サブスクリプションのキー管理エリアを開きます。
- Kimi Code キーを作成してコピーします。
Kimi Code キーは
https://api.kimi.com/coding/v1 に対してのみ動作します。api.moonshot.ai に送信すると 401 を返します。Kodus で Moonshot を設定する
主なフローは Kodus Cloud の AI providers ページです。プロセスレベルでプロバイダーを固定することを好むセルフホストユーザーは、代わりに環境変数を使用できます。オプション1 — Kodus Cloud の Moonshot プロバイダー(Developer API に推奨)
1
AI providers を開き Moonshot を選択
サイドバーで AI providers を開きます(app.kodus.io/byok)。Providers タブで Moonshot タイルをクリックします(Connect your first provider の下、またはすでにプロバイダーを接続している場合は Add another provider の下)。
2
APIキーを貼り付けてモデルを選択
platform.moonshot.ai の Developer API キーを API key カードに貼り付けます。すると Model ピッカーが Moonshot のモデルを読み込みます — いずれか(例:
kimi-k2.6)を選ぶか、Type model manually を選択します。Kodus は https://api.moonshot.ai/anthropic エンドポイントを自動で入力します。このタイルにはプランセレクターもベース URL フィールドもないため、Kimi Code Plan のキー(または中国プラットフォーム)には下記のオプション2を使用してください。3
Test & save
Test & save をクリックします。Kodus は接続をテストし、成功時に設定を保存します。401 はキーがエンドポイントと一致しないことを意味します。
Reasoning のチューニング(任意)
Thinking / Reasoning は Advanced (optional) の下にあります。Kimi では、Off 以外のレベルはすべてthinking: { type: "enabled" } を生成します。オーバーライドするには、Thinking / Reasoning を Custom に切り替えて、次のいずれかを貼り付けます:
-
小さな PR でより高速/安価なレビューのために thinking を無効化:
-
特定のトークン予算を強制(Moonshot がティアで
budget_tokensのサポートを追加した場合):
名前空間のラップは不要です — Kodus が送信前にオプションをアクティブなプロバイダーの名前空間でラップします。詳しくは main BYOK doc → Custom JSON override を参照してください。
同時実行数のチューニング
- Kimi Code Plan:Max concurrent requests(Advanced (optional) の下)を
30(文書化された上限)に設定します。それ以上にすると 429 を返します。 - Developer API:空のまま開始(制限なし)。実際の制限はリチャージティアとスケールします — Tier 1(約3000)は約1000 を許可。レビュー時に 429 が発生した場合は明示的に下げてください。
Routing タブで Kimi を Model for all tasks に、OpenAI または Anthropic のモデルを Fallback (optional) に設定します — Moonshot が 429 または 402 を返した場合、Kodus は自動的にフェイルオーバーします。
オプション2 — OpenAI 互換エンドポイント
Kimi Code Plan、中国プラットフォーム、または Moonshot の OpenAI 互換エンドポイントを使う場合は、AI providers を開き、Providers タブの Custom の下にある OpenAI-compatible を選択して以下を入力します:オプション3 — セルフホスト(環境変数)
固定モード(単一グローバルプロバイダー、組織ごとの BYOK なし)で Kodus を実行している場合は、API とワーカーコンテナの.env で Moonshot を設定します:
このパスは意図的に BYOK を無効にしているセルフホスト Kodus インストールにのみ必要です。セルフホストインスタンスで BYOK が有効な場合は、オプション1またはオプション2を優先してください — AI providers ページはクラウドと同じように動作します。
.env を編集後、API とワーカーコンテナを再起動して統合を確認します:
Kimi Code Plan、Developer API、アグリゲーターの選択
- Kimi Code Plan — 予測可能な定額コスト、30 concurrent の上限、コーディングワークフロー向けに最適化された専用の
api.kimi.com/coding/v1エンドポイント。予測可能な PR ボリュームを持つ定常運用チームに最適。 - Moonshot Developer API — ペイパートークン、同時実行数はリチャージティアとスケール、最大の柔軟性。バースト的なワークロードに最適。
- OpenRouter プロキシ — 多くのプロバイダーにわたる1つの請求関係が欲しい場合、OpenRouter は小さなルーティングマークアップで Kimi モデルを公開します。Kimi が混在プロバイダーフリートの一部で、主要なワークロードではない場合に選択してください。
トラブルシューティング
Test 後の 401 — キーがエンドポイントと一致しない
Test 後の 401 — キーがエンドポイントと一致しない
- Kimi Code Plan キーは
api.kimi.com/coding/v1に対してのみ動作します。 platform.moonshot.aiからの Developer API キーはapi.moonshot.ai/v1に対してのみ動作します。platform.moonshot.cnからの Developer API キーはapi.moonshot.cn/v1に対してのみ動作します。- Moonshot タイルは常に
https://api.moonshot.ai/anthropicを使用するため、platform.moonshot.aiのキーが必要です。Kimi Code Plan またはplatform.moonshot.cnのキーは、対応する Base URL を指定して OpenAI-compatible 経由で接続してください。
残高不足
残高不足
- Developer API はペイパートークンで課金します。残高が尽きた場合、リクエストは HTTP 402 を返します。
- コンソールの請求セクションで資金を追加するか、驚きを避けるために月次上限を設定します。
- Kimi Code Plan は定額価格ですが、30 concurrent の上限とクォータウィンドウに縛られます — 429 はそれらのいずれかに達したことを意味します。
モデルが見つからない
モデルが見つからない
- モデル名がカタログと一致していることを確認します(
kimi-k2.6、kimi-k2.6、kimi-k2.5、kimi-k2-0905、kimi-k2)。 - 最新リストについては platform.kimi.ai/docs を確認してください — 新しいバージョンが定期的にリリースされます。
最初のレスポンスが遅い
最初のレスポンスが遅い
- 非アクティブ期間後の最初の呼び出しは Moonshot 側でコールドスタートする可能性があります。
- レイテンシが重要な場合、定期的なレビューには
kimi-k2-0905が一般的に K2.6 バリアントよりも高速です。
リージョン / 接続性
リージョン / 接続性
- 中国以外のユーザーは常に
api.moonshot.aiまたはapi.kimi.comを使用してください。api.moonshot.cnは中国本土外から到達できないかレート制限される場合があります。 - Kodus デプロイから選択したエンドポイントへのアウトバウンド HTTPS が許可されていることを確認します。