月之暗面 · 超长上下文 · 国内直连

Kimi（月之暗面）配置教程

Kimi 是月之暗面（Moonshot AI）推出的国产大模型，主打超长上下文和 K2 系列开源模型，对长文档、长对话、Agent 工作流非常友好。

开始配置 模型对比 常见问题
← 总览教程 DeepSeek 教程 通义千问教程 Claude 教程 →

为什么选择 Kimi？

  • 超长上下文 — 8K / 32K / 128K / 256K 多档可选，长文档与多轮对话表现稳
  • K2 系列开源 — Kimi-K2-Instruct 等开源模型，可对接龙虾或私有化部署
  • 国内直连 — 服务器在国内，无需翻墙，访问速度快
  • OpenAI 兼容 — API 格式与 OpenAI 完全一致，配置极简
  • Agent / 工具调用 — 支持 function calling 和 tool use，适合龙虾的 Skills 场景

分步教程

通过 Moonshot 开放平台，5 分钟完成配置

1

注册 Moonshot 开放平台

Kimi 的 API 服务由 Moonshot 开放平台提供，与 kimi.com 网页聊天版账号体系是分开的。

  1. 访问 platform.moonshot.cn（开放平台）
  2. 点击 "登录 / 注册"
  3. 使用手机号注册，输入验证码
  4. 登录后完成实名认证（按平台提示）
  5. 进入控制台首页
提示：新用户注册即送免费额度（通常 ¥15 试用金），足够体验所有模型。
注意：kimi.com（聊天版）和 platform.moonshot.cn（开放平台）是两套账号体系，需要分别注册。
2

充值（可选）

免费额度用完后再考虑充值。Kimi 支持支付宝、微信付款。

  1. 登录后点击左侧 "账户余额" 或 "费用中心"
  2. 点击 "充值"
  3. 选择金额（最低 ¥10 起）
  4. 使用支付宝 / 微信扫码付款
建议：先把免费额度用完，确认 Kimi 适合你的场景后再充值。Kimi 价格中等，建议根据使用量充值。
3

创建 API Key

在 Moonshot 控制台创建 API 密钥。

  1. 左侧菜单点击 "API Key 管理"
  2. 点击 "新建 API Key"
  3. 填写名称（如 "XiaoJuClaw"）
  4. 选择关联的项目（默认即可）
  5. 复制生成的密钥（以 sk- 开头）
  6. 立即保存，关闭页面后无法再次查看
# Kimi API Key 格式示例
sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
安全提醒：不要在公开仓库或聊天群里贴 Key。一旦泄露请立即在控制台删除并重建。
4

在龙虾中配置 Kimi

Kimi API 完全兼容 OpenAI 格式，龙虾选择 "OpenAI Compatible" 即可。

  1. 打开龙虾客户端 → "设置" → "模型配置"
  2. 选择 "OpenAI Compatible" / "自定义提供商"
  3. 填写以下信息：
    • API Key：粘贴你的 Kimi 密钥
    • Base URL：https://api.moonshot.cn/v1
    • 模型名称：moonshot-v1-128k 或 kimi-k2-0711-preview 等
  4. 点击 "测试连接" 确认成功
  5. 保存设置
# 环境变量配置
OPENAI_API_KEY=sk-你的Kimi密钥
OPENAI_BASE_URL=https://api.moonshot.cn/v1
MODEL_NAME=moonshot-v1-128k
关键点：Base URL 末尾必须带 /v1。模型名要从下方表格里选一个对应的具体型号，不能只写 "kimi"。
5

验证并开始使用

发送测试消息确认接入正常：

  1. 在龙虾对话框输入 "你好，请介绍一下你自己"
  2. 如果回复中提到 Kimi / Moonshot，说明配置成功
  3. 报错时检查：Key、Base URL、模型名是否正确，账户余额是否充足
完成！试试用 Kimi 处理一份长文档，体验它的超长上下文优势。

Kimi 主流模型

价格以官方公布为准，请到平台费用页查看最新报价。

模型名称 上下文 适用场景 价格档位（每百万 tokens） 推荐
moonshot-v1-8k 8K 简短对话、问答 低（约 ¥12 / ¥12） 轻量场景
moonshot-v1-32k 32K 常规任务、文章生成 中（约 ¥24 / ¥24） ⭐ 日常推荐
moonshot-v1-128k 128K 长文档、多轮对话、代码库 较高（约 ¥60 / ¥60） ⭐ 长上下文首选
kimi-k2-0711-preview 128K K2 旗舰，推理与编程 中（参考官网） ⭐ 综合能力强
moonshot-v1-auto 自动 自动选择上下文长度 按实际命中档位计费 省心
选型建议：处理长文档/代码库选 moonshot-v1-128k；不确定长度选 moonshot-v1-auto；想体验最新 K2 能力选 kimi-k2-0711-preview。

常见问题

Kimi / Moonshot 相关的常见疑问

Kimi 和 ChatGPT 比怎么样？适合什么场景？
Kimi 在中文表现、超长上下文（128K / 256K）和长文档分析上有明显优势，价格中等。综合写作和推理能力接近 GPT-4 水平。最适合：长文档总结、整本书阅读、长对话保持记忆、代码库分析等"上下文密集型"场景。
kimi.com 和 platform.moonshot.cn 是什么关系？
  • kimi.com：Kimi 网页聊天版，给普通用户用，注册即可对话
  • platform.moonshot.cn：Moonshot 开放平台，给开发者/工具用，提供 API Key
龙虾需要的是 开放平台的 API Key。两个平台账号独立，需要分别注册。
我应该选 8k / 32k / 128k 哪一个？
上下文长度直接影响价格。一般原则：
  • 简单问答 / 短对话 → 选 8k 或 32k，便宜
  • 处理整篇长文 / 代码库 / 长对话 → 选 128k
  • 不确定 → 选 moonshot-v1-auto，平台会自动匹配最便宜的档位
龙虾通常有"模型切换"，可以日常用 32k，需要时再切到 128k。
Kimi K2 能做什么？开源版怎么用？
Kimi K2 是月之暗面最新一代旗舰模型，强化了推理、Agent 能力和工具调用。云端可通过 kimi-k2-0711-preview 等模型名调用。开源版（如 Kimi-K2-Instruct）已发布在 HuggingFace / ModelScope，技术能力强的用户可本地部署或使用 vLLM/SGLang 推理服务。
我有 Kimi 网页版会员，API 也是免费的吗？
不是。Kimi 网页版和 API 是两套计费体系，会员只覆盖网页/App 使用。API 调用单独按 token 计费，但平台会给开发者送一些试用金。
报错 "Authentication failed" 或 "Invalid API key" 怎么办？
常见原因：
  • Key 复制时多了空格 → 重新仔细复制
  • Key 已被删除 → 去控制台重建
  • Base URL 拼错 → 必须是 https://api.moonshot.cn/v1
  • 用了网页版账号的 Cookie → API 不通用，必须创建开放平台 API Key

开始使用 Kimi

超长上下文，国内直连，长文档场景王者

前往 Moonshot 平台 返回总览教程 查看 Claude 教程