> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kodus.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Moonshot (Kimi) - OpenAI 互換推論

> Moonshot Developer API または Kimi Code Plan を通じて Moonshot AI の Kimi K2.6 モデルを Kodus に接続する方法を学びます。

## 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）。

> [!NOTE]
>
> 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（サブスクリプション）

| 属性 | 値 |
| - | - |
| **エンドポイント** | `https://api.kimi.com/coding/v1` |
| **同時実行数** | 30 concurrent リクエストで上限 |
| **請求** | 定額サブスクリプション |
| **キーの取得元** | [kimi.com/code](https://www.kimi.com/code) |

### Developer API（ペイパートークン）

| モデル | 価格（入力/出力トークン 100万当たり） | コンテキストウィンドウ | 備考 |
| - | - | - | - |
| **Kimi K2.6 Coding** `推奨` | 約$0.60 / $2.50 | 約256kトークン | 最新、コードレビュー向けにチューニング済み。 |
| **Kimi K2.5** | $0.60 / $2.50 | 約256kトークン | 前世代、まだ有能。 |
| **Kimi K2 (0905)** | より低い価格帯 | 約128kトークン | 安定した汎用モデル。 |

Developer API エンドポイント：`https://api.moonshot.ai/v1`（国際）。同時実行数はリチャージティアとスケール — Tier 1（\$10 リチャージ）は約50 concurrent から開始し、Tier 5 では最大約1000 concurrent。

## APIキーの作成

> [!WARNING]
>
> APIキーを作成するには Moonshot アカウントが必要です。

**Kimi Code Plan サブスクライバー**

1. [kimi.com/code](https://www.kimi.com/code) にアクセスしてプランにサブスクライブします。
2. サブスクリプションのキー管理エリアを開きます。
3. Kimi Code キーを作成してコピーします。

> [!NOTE]
>
> Kimi Code キーは `https://api.kimi.com/coding/v1` に対してのみ動作します。`api.moonshot.ai` に送信すると 401 を返します。

**Developer API（ペイパートークン）**

1. [platform.moonshot.ai](https://platform.moonshot.ai) でサインインします（中国本土内で運営する場合は [platform.moonshot.cn](https://platform.moonshot.cn)）。
2. 支払い方法を追加します — Moonshot は最初に請求を追加したときに少額のスターター残高を付与する場合があります。
3. [platform.moonshot.ai/console/api-keys](https://platform.moonshot.ai/console/api-keys) で **API Keys** セクションを開きます。
4. **Create API Key** をクリックし、説明的な名前（例：`kodus-prod`）を付けてすぐにキーをコピーします。

> [!NOTE]
>
> Developer API キーは `api.moonshot.ai/v1`（国際）または `api.moonshot.cn/v1`（中国）に対してのみ動作します。キーはリージョン間で**ポータブルではありません**。

## Kodus で Moonshot を設定する

主なフローは Kodus Cloud の **AI providers** ページです。プロセスレベルでプロバイダーを固定することを好むセルフホストユーザーは、代わりに環境変数を使用できます。

### オプション1 — Kodus Cloud の Moonshot プロバイダー（Developer API に推奨）

**1. AI providers を開き Moonshot を選択**

サイドバーで **AI providers** を開きます（[app.kodus.io/byok](https://app.kodus.io/byok)）。**Providers** タブで **Moonshot** タイルをクリックします（**Connect your first provider** の下、またはすでにプロバイダーを接続している場合は **Add another provider** の下）。

**2. APIキーを貼り付けてモデルを選択**

[platform.moonshot.ai](https://platform.moonshot.ai/console/api-keys) の 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 を無効化**：

  ```json theme={null}
  {
    "thinking": { "type": "disabled" }
  }
  ```

* **特定のトークン予算を強制**（Moonshot がティアで `budget_tokens` のサポートを追加した場合）：

  ```json theme={null}
  {
    "thinking": { "type": "enabled", "budget_tokens": 25000 }
  }
  ```

> [!NOTE]
>
> 名前空間のラップは不要です — Kodus が送信前にオプションをアクティブなプロバイダーの名前空間でラップします。詳しくは [main BYOK doc → Custom JSON override](https://docs.kodus.io/ja/how_to_use/byok.md#カスタム-json-オーバーライド) を参照してください。

### 同時実行数のチューニング

* **Kimi Code Plan**：**Max concurrent requests**（**Advanced (optional)** の下）を `30`（文書化された上限）に設定します。それ以上にすると 429 を返します。
* **Developer API**：空のまま開始（制限なし）。実際の制限はリチャージティアとスケールします — Tier 1（約$10 リチャージ）は約50 concurrent を許可；Tier 5（約$3000）は約1000 を許可。レビュー時に 429 が発生した場合は明示的に下げてください。

> [!NOTE]
>
> **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** を選択して以下を入力します：

| フィールド | 値 |
| - | - |
| **ベース URL** | `https://api.moonshot.ai/v1`（Developer API） `https://api.kimi.com/coding/v1`（Kimi Code Plan） `https://api.moonshot.cn/v1`（中国本土のみ） |
| **モデル** | `kimi-k2.6`、`kimi-k2.6`、`kimi-k2.5`、`kimi-k2-0905`、`kimi-k2` |
| **API key** | Moonshot または Kimi Code キー（上記のベース URL と一致） |
| **Max concurrent requests**（**Advanced (optional)** の下） | Kimi Code Plan では `30`；Developer API では空のまま（リチャージティアとスケール） |

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

固定モード（単一グローバルプロバイダー、組織ごとの BYOK なし）で Kodus を実行している場合は、API とワーカーコンテナの `.env` で Moonshot を設定します：

```env theme={null}
# Moonshot (Kimi) configuration (Fixed Mode)
API_LLM_PROVIDER_MODEL="kimi-k2.6"
API_OPENAI_FORCE_BASE_URL="https://api.moonshot.ai/v1"    # or https://api.kimi.com/coding/v1 for Kimi Code Plan
API_OPEN_AI_API_KEY="your-moonshot-or-kimi-code-api-key"
```

> [!NOTE]
>
> このパスは意図的に BYOK を無効にしているセルフホスト Kodus インストールにのみ必要です。セルフホストインスタンスで BYOK が有効な場合は、**オプション1**または**オプション2**を優先してください — **AI providers** ページはクラウドと同じように動作します。

`.env` を編集後、API とワーカーコンテナを再起動して統合を確認します：

```bash theme={null}
docker-compose logs api worker | grep -iE "moonshot|kimi"
```

完全なセルフホストセットアップ（ドメイン、セキュリティキー、データベース、Webhook、リバースプロキシ）については、[汎用VMデプロイガイド](https://docs.kodus.io/ja/how_to_deploy/deploy_kodus/generic_vm.md) に従い、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 が混在プロバイダーフリートの一部で、主要なワークロードではない場合に選択してください。

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

> **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](https://platform.kimi.ai/docs) を確認してください — 新しいバージョンが定期的にリリースされます。

> **最初のレスポンスが遅い**
>
> * 非アクティブ期間後の最初の呼び出しは Moonshot 側でコールドスタートする可能性があります。
> * レイテンシが重要な場合、定期的なレビューには `kimi-k2-0905` が一般的に K2.6 バリアントよりも高速です。

> **リージョン / 接続性**
>
> * 中国以外のユーザーは常に `api.moonshot.ai` または `api.kimi.com` を使用してください。`api.moonshot.cn` は中国本土外から到達できないかレート制限される場合があります。
> * Kodus デプロイから選択したエンドポイントへのアウトバウンド HTTPS が許可されていることを確認します。

## 関連リンク

* [Moonshot プラットフォーム（国際）](https://platform.moonshot.ai)
* [Kimi Code Plan](https://www.kimi.com/code)
* [Kimi API ドキュメント](https://platform.kimi.ai/docs)
* [BYOK の概要](https://docs.kodus.io/ja/how_to_use/byok.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.