メインコンテンツへスキップ

​
Moonshotの動作方法

Moonshot AIはKimiファミリーのモデル（Kimi K2、K2 Thinking、K2.5）を公開しています。Kimiは長コンテキストのコード理解とエージェントタスクに特に強く、APIは完全にOpenAI互換のため、KodusはRed既存のOpenAI互換アダプターで通信できます。
Moonshotのコンサマーサブスクリプション（Andante、Moderatoなど）はKimi.aiチャット製品に適用され、APIには適用されません。API使用量は、保有するチャットサブスクリプションに関係なくペイパートークンで課金されます。これはAPIクォータを直接サブスクリプションで付与するZ.AIなどのプロバイダーとは異なります。
Moonshotは2つの並行プラットフォームを運営しています：
  • 国際 — platform.moonshot.ai — ベースURL https://api.moonshot.ai/v1。USDで課金。中国以外のユーザーのデフォルト。
  • 中国 — platform.moonshot.cn — ベースURL https://api.moonshot.cn/v1。CNYで課金。中国本土内で既に運営している場合のみ使用。

​
推奨モデル

最新のカタログと価格については、platform.moonshot.aiを参照してください。
モデル価格（入力/出力トークン100万当たり）コンテキストウィンドウ備考
Kimi K2.5 推奨0.60/0.60 / 2.50約256kトークン最新世代、最強のコーディング結果。
Kimi K2 Thinking約0.60/0.60 / 2.50約256kトークン推論バリアント；レビューが深い分析を必要とする場合に使用。
Kimi K2 (0905)より低い価格帯約128kトークン安定した汎用モデル。
3つすべてに同じベースURLと異なる model 名でアクセスできます：
  • kimi-k2.5
  • kimi-k2-thinking
  • kimi-k2-0905
  • kimi-k2

​
APIキーの作成

APIキーを作成するにはMoonshotアカウントが必要です。
  1. platform.moonshot.aiにアクセスしてアカウントを作成します（またはサインイン）。中国本土のユーザーは代わりにplatform.moonshot.cnを使用してください。
  2. 支払い方法を追加します — Moonshotは国際プラットフォームで必須の無料トライアルを提供していません；最初に請求を追加したときに少額のクレジットが付与される場合があります。
  3. コンソールのAPIキーセクションを開きます。
  4. APIキーを作成をクリックし、説明的な名前（例：kodus-prod）を付けてすぐにキーをコピーします。

​
KodusでMoonshotを設定する

主なフローはKodus CloudでのBYOKです — MoonshotキーをウェブUIに貼り付ければ完了です。プロセスレベルでプロバイダーを固定することを好むセルフホストユーザーは代わりに環境変数を使用できます。

​
オプション1 — Kodus CloudでのBYOK（推奨）

  1. Kodusウェブ UIで、設定 → BYOKを開き、メインモデル（またはKimiをバックアップとして使いたい場合はフォールバック）の編集をクリックします。
  2. ベースURLと自由テキストのモデル名を入力できるよう、フォームをカスタムモードに切り替えます。
  3. フィールドを入力します：
    フィールド値
    プロバイダーOpenAI Compatible
    APIキーMoonshot APIキー
    ベースURLhttps://api.moonshot.ai/v1（国際）
    https://api.moonshot.cn/v1（中国本土のみ）
    モデルkimi-k2.5（推奨） — または kimi-k2-thinking、kimi-k2-0905、kimi-k2
    最大同時リクエスト数5〜10 が良い出発点；Moonshotはアカウントごとに寛大な制限があります
    最大入力トークンK2.5の256kウィンドウのために上げることができます；そうでなければデフォルトのまま
  4. 保存します。Kodusはエンドポイントに対してキーを検証し、401 / 404があれば即座に表示されます。
  5. 任意のPRを開いてレビューをトリガーし、Moonshotがレスポンスを提供していることを確認します — 設定のBYOKステータスバッジは最初の成功した呼び出しで緑になります。
Kimi K2.5の長コンテキストは大きなPRや多くのファイルにまたがるコードで輝きます。ほとんどのレビューが小さなPRの場合、kimi-k2-0905 はそのワークロードに対してほぼ同じ品質でより速く安価です。
Moonshotをメインとして設定し、OpenAIまたはAnthropicキーをフォールバックとして保持できます — MoonshotがHTTP 429または402を返した場合、Kodusは自動的にフェイルオーバーします。

​
オプション2 — セルフホスト（環境変数）

固定モード（単一グローバルプロバイダー、BYOKなし）でKodusを実行している場合は、APIとワーカーコンテナの .env でMoonshotを設定します： 
# Moonshot（Kimi）設定（固定モード）
API_LLM_PROVIDER_MODEL="kimi-k2.5"
API_OPENAI_FORCE_BASE_URL="https://api.moonshot.ai/v1"    # 中国プラットフォームには.cnを使用
API_OPEN_AI_API_KEY="your-moonshot-api-key"
このパスは意図的にBYOKを無効にしているセルフホストKodusインストールにのみ必要です。セルフホストインスタンスでBYOKが有効な場合は、オプション1を優先してください — UIベースのフローはクラウドと同じです。
.env を編集後、APIとワーカーコンテナを再起動して統合を確認します： 
docker-compose logs api worker | grep -iE "moonshot|kimi"
完全なセルフホストセットアップ（ドメイン、セキュリティキー、データベース、Webhook、リバースプロキシ）については、汎用VMデプロイガイドに従い、LLMブロックのみ上記のものと置き換えてください。

​
Moonshotとアグリゲーターの選択

Kimi K2.5はKodusの一流プロバイダーとしてすでにサポートされているOpenRouterを通じてもアクセスできます。トレードオフ：
  • Moonshot直接API — 最低のトークン当たりコスト、最大のコンテキストウィンドウ、ネイティブのレート制限。Moonshotアカウントと請求が必要。
  • OpenRouterプロキシ — 多くのプロバイダーへの単一の請求関係ですが、小さなルーティングマークアップとわずかに遅いコールドスタート。
Kimiが主なモデルで最良のコストとコンテキストが欲しい場合はMoonshot直接を選択してください。多くのプロバイダーを混在させて単一の請求を保ちたい場合はOpenRouterを選択してください。

​
トラブルシューティング

  • Moonshotコンソールでキーがアクティブであることを確認します。
  • ベースURLがキーを作成したプラットフォームと一致していることを確認します — platform.moonshot.ai からのキーは api.moonshot.cn に対しては機能しません（逆も同様）。
  • .env の値に末尾のスペースや引用符がないことを確認します。
  • Moonshotは必須サブスクリプションなしでペイパートークン課金です。残高が尽きた場合、リクエストはHTTP 402を返します。
  • コンソールの請求セクションで資金を追加するか、驚きを避けるために月次上限を設定します。
  • モデル名がカタログと一致していることを確認します（kimi-k2.5、kimi-k2-thinking、kimi-k2-0905、kimi-k2）。
  • 新しいモデルバージョンが定期的にリリースされます — 最新リストについてはKimiドキュメントを確認してください。
  • 非アクティブ期間後の最初の呼び出しはMoonshot側でコールドスタートする可能性があります。
  • レイテンシが重要な場合は、定期的なコードレビューにはthinkingバリアントよりも kimi-k2-0905 を優先します。
  • 中国以外のユーザーは常に api.moonshot.ai を使用してください；api.moonshot.cn は中国本土以外から到達できないかレート制限される場合があります。
  • Kodusデプロイから api.moonshot.ai へのアウトバウンドHTTPSが許可されていることを確認します。

​
関連リンク