> ## 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 AI 的 Kimi K2.6 模型连接到 Kodus — 通过 Moonshot 开发者 API 或 Kimi Code Plan。

## Moonshot 工作原理

Moonshot AI 发布 **Kimi** 系列模型(K2、K2.5、K2.6、K2.6 Coding)。Kimi 在长上下文代码理解和 Agent 型任务上表现尤为突出,其 API 完全兼容 OpenAI — Kodus 可以通过 **OpenAI-compatible** 提供商与之对接。Kodus 还提供专用的 **Moonshot** 提供商,它通过 Moonshot 的 Anthropic 兼容端点(`https://api.moonshot.ai/anthropic`)进行连接。

Moonshot 为同一模型系列提供**两条路径**,各自有独立端点:

* **开发者 API**(`platform.moonshot.ai`)— 按 token 付费,按用量计费。并发随充值档位伸缩。
* **Kimi Code Plan**(`kimi.com/code`)— 带**专用编码端点**的订阅。统一定价,并发被封顶(30 并发)。

> [!NOTE]
>
> Moonshot 的消费者 Kimi.com 聊天订阅(Andante、Moderato 等)与上述两条 API 路径均无关。聊天订阅**不**授予 API 访问权限。Kimi Code Plan 才是针对 API 的订阅。

Moonshot 还运营一个仅限中国大陆的平台(`platform.moonshot.cn`,基础 URL 为 `https://api.moonshot.cn/v1`),以人民币计费。仅当您在中国大陆运营时使用。

## 方案概览

### Kimi Code Plan(订阅)

| 属性 | 值 |
| - | - |
| **端点** | `https://api.kimi.com/coding/v1` |
| **并发** | 上限 30 个并发请求 |
| **计费** | 统一月费订阅 |
| **密钥来源** | [kimi.com/code](https://www.kimi.com/code) |

### 开发者 API(按 token 付费)

| 模型 | 价格(每 100 万 输入 / 输出 token) | 上下文窗口 | 说明 |
| - | - | - | - |
| **Kimi K2.6 Coding** `推荐` | 约 $0.60 / $2.50 | 约 256k tokens | 最新版,针对代码审查调优。 |
| **Kimi K2.5** | $0.60 / $2.50 | 约 256k tokens | 上一代,仍有很强能力。 |
| **Kimi K2 (0905)** | 更低价格档位 | 约 128k tokens | 稳定的通用模型。 |

开发者 API 端点:`https://api.moonshot.ai/v1`(国际版)。并发随充值档位伸缩 — Tier 1(\$10 充值)起始约 50 并发,Tier 5 最多约 1000 并发。

## 创建 API 密钥

> [!WARNING]
>
> 创建 API 密钥需要 Moonshot 账号。

> [tab] 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。

> [tab] 开发者 API(按 token 付费)
>
> 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]
> >
> > 开发者 API 密钥仅适用于 `api.moonshot.ai/v1`(国际版)或 `api.moonshot.cn/v1`(中国版)。密钥在**两个区域之间不可移植**。

## 在 Kodus 中配置 Moonshot

主流程是使用 Kodus Cloud 上的 **AI providers** 页面。希望在进程层级固定提供商的自托管用户可以改用环境变量。

### 方式 1 — Kodus Cloud 上的 Moonshot 提供商(推荐用于开发者 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 密钥并选择模型**

在 **API key** 卡片中粘贴来自 [platform.moonshot.ai](https://platform.moonshot.ai/console/api-keys) 的开发者 API 密钥。随后 **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 表示密钥与端点不匹配。

### 调优推理(可选)

**Thinking / Reasoning** 位于 **Advanced (optional)** 下。对于 Kimi,除 Off 以外的任何级别都会发出 `thinking: { type: "enabled" }`。如需覆盖,请将 **Thinking / Reasoning** 切换为 **Custom** 并粘贴以下任一配置:

* **禁用 thinking**,在小型 PR 上实现更快/更便宜的审查:

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

* **强制特定 token 预算**(如果 Moonshot 在您的档位支持 `budget_tokens`):

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

> [!NOTE]
>
> 无需命名空间包装 — Kodus 在发送前会将选项包装在当前提供商的命名空间下。详见 [主 BYOK 文档 → 自定义 JSON 覆盖](https://docs.kodus.io/zh/how_to_use/byok.md#自定义-json-覆盖)。

### 调优并发

* **Kimi Code Plan**:将 **Max concurrent requests**(位于 **Advanced (optional)** 下)设置为 `30`(文档上限)。更高会返回 429。
* **开发者 API**:保持为空(无上限)。实际限制随充值档位伸缩 — Tier 1(约 $10 充值)允许约 50 并发;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**,并填写:

| 字段 | 值 |
| - | - |
| **Base URL** | `https://api.moonshot.ai/v1`(开发者 API) `https://api.kimi.com/coding/v1`(Kimi Code Plan) `https://api.moonshot.cn/v1`(仅限中国大陆) |
| **Model** | `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`;开发者 API 保持为空(随充值档位伸缩) |

### 方式 3 — 自托管(环境变量)

如果您以 Fixed Mode 运行 Kodus(单一全局提供商,无按组织 BYOK),在 API + worker 容器的 `.env` 中配置 Moonshot:

```env theme={null}
# Moonshot(Kimi)配置(固定模式)
API_LLM_PROVIDER_MODEL="kimi-k2.6"
API_OPENAI_FORCE_BASE_URL="https://api.moonshot.ai/v1"    # Kimi Code Plan 使用 https://api.kimi.com/coding/v1
API_OPEN_AI_API_KEY="your-moonshot-or-kimi-code-api-key"
```

> [!NOTE]
>
> 仅在有意禁用 BYOK 的自托管 Kodus 安装中才需要这条路径。如果您的自托管实例启用了 BYOK,请优先使用**方式 1**或**方式 2** — **AI providers** 页面的用法与 Cloud 上相同。

编辑 `.env` 后重启 API 和 worker 容器,然后验证集成:

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

完整的自托管设置(域名、安全密钥、数据库、webhook、反向代理)请参见[通用 VM 部署指南](https://docs.kodus.io/zh/how_to_deploy/deploy_kodus/generic_vm.md),只需将 LLM 部分替换为上面的配置。

## 在 Kimi Code Plan、开发者 API 和聚合器之间选择

* **Kimi Code Plan** — 可预测的统一月费、30 并发上限、专为编码工作流优化的专用 `api.kimi.com/coding/v1` 端点。适合 PR 流量稳定、团队常态化运行的场景。
* **Moonshot 开发者 API** — 按 token 付费,并发随充值档位伸缩,灵活度最高。适合波动性负载。
* **OpenRouter 代理** — 如果您希望多个提供商统一结算,OpenRouter 以少量路由加价暴露 Kimi 模型。当 Kimi 是混合提供商矩阵中的一员、而不是主要工作负载时选择它。

## 故障排查

> [accordion] Test 后 401 — 密钥与端点不匹配
>
> * Kimi Code Plan 密钥仅在 `api.kimi.com/coding/v1` 上工作。
> * 来自 `platform.moonshot.ai` 的开发者 API 密钥仅在 `api.moonshot.ai/v1` 上工作。
> * 来自 `platform.moonshot.cn` 的开发者 API 密钥仅在 `api.moonshot.cn/v1` 上工作。
> * **Moonshot** 磁贴始终使用 `https://api.moonshot.ai/anthropic`,因此需要 `platform.moonshot.ai` 的密钥。Kimi Code Plan 或 `platform.moonshot.cn` 的密钥请通过 **OpenAI-compatible** 并配合相应的 **Base URL** 连接。

> [accordion] 余额不足
>
> * 开发者 API 按 token 付费。余额耗尽时请求返回 HTTP 402。
> * 在控制台的账单页面充值,或设置月度上限以避免超支。
> * Kimi Code Plan 虽然是统一定价,但受 30 并发上限和配额窗口约束 — 429 意味着您撞到了其中之一。

> [accordion] 模型未找到
>
> * 确认模型名称与目录匹配(`kimi-k2.6`、`kimi-k2.6`、`kimi-k2.5`、`kimi-k2-0905`、`kimi-k2`)。
> * 请查看 [platform.kimi.ai/docs](https://platform.kimi.ai/docs) 了解当前列表 — 新版本发布频繁。

> [accordion] 首次响应慢
>
> * 一段时间闲置后的首次调用可能在 Moonshot 侧冷启动。
> * 如果延迟重要,`kimi-k2-0905` 在常规审查上通常比 K2.6 变体更快。

> [accordion] 区域 / 连接性
>
> * 中国大陆以外的用户应始终使用 `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/zh/how_to_use/byok.md)


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