Skip to main content

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 専用のサブスクリプションです。
Moonshot は中国限定のプラットフォーム(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キーの作成

APIキーを作成するには Moonshot アカウントが必要です。
  1. kimi.com/code にアクセスしてプランにサブスクライブします。
  2. サブスクリプションのキー管理エリアを開きます。
  3. 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(約10リチャージ)は約50concurrentを許可;Tier5(約10 リチャージ)は約50 concurrent を許可;Tier 5(約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 とワーカーコンテナを再起動して統合を確認します:
完全なセルフホストセットアップ(ドメイン、セキュリティキー、データベース、Webhook、リバースプロキシ)については、汎用VMデプロイガイド に従い、LLM ブロックのみ上記のものと置き換えてください。

Kimi Code Plan、Developer API、アグリゲーターの選択

  • Kimi Code Plan — 予測可能な定額コスト、30 concurrent の上限、コーディングワークフロー向けに最適化された専用の api.kimi.com/coding/v1 エンドポイント。予測可能な PR ボリュームを持つ定常運用チームに最適。
  • Moonshot Developer API — ペイパートークン、同時実行数はリチャージティアとスケール、最大の柔軟性。バースト的なワークロードに最適。
  • OpenRouter プロキシ — 多くのプロバイダーにわたる1つの請求関係が欲しい場合、OpenRouter は小さなルーティングマークアップで Kimi モデルを公開します。Kimi が混在プロバイダーフリートの一部で、主要なワークロードではない場合に選択してください。

トラブルシューティング

  • 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 が許可されていることを確認します。

関連リンク