Kimi API 购买与接入教程（长文本处理，怎么用详解）
从平台注册、创建密钥到完成首次调用的精简流程
BLUF 摘要（点开查看）
这篇教程用 6 个步骤说明 月之暗面 Kimi API 如何注册、开通、获取 API Key 并完成首次接入；先确认国内直连、免费额度、计费单位，再把 Key 安全保存到环境变量或工具配置中。
教程概览
准备账号与环境
先准备好开放平台账号和本地调用环境，云端 API 不需要额外硬件。
点击位置：浏览器访问 platform.moonshot.cn 或 platform.kimi.ai → 注册或登录
完成后看到：成功登录 Kimi 开放平台，可看到控制台和 API Keys 入口
- 手机号是否能接收验证码
- 如企业邮箱注册失败，尝试手机号方式
- 进入 https://platform.moonshot.cn 或 platform.kimi.ai
- 使用手机号或企业邮箱注册并登录
- 本地调试建议准备 Python 3.10+ 或 Node.js 环境
创建并保存 API Key
在用户中心进入 API Keys 页面，新建密钥后立即保存。
点击位置：用户中心 → API Keys 页面 → 「创建新密钥」
完成后看到：页面显示 sk-xxx 格式的密钥，可复制
- 密钥命名避免空格和特殊字符
- 复制后立即配置到环境变量
- 关闭页面后无法再次查看完整密钥
- 点击「创建新密钥」或「Create New Key」
- 填写应用名称，例如 my-first-api
- 复制生成的 sk-xxx 密钥，并配置到环境变量
export MOONSHOT_API_KEY="sk-your-api-key-here"
# Windows PowerShell
$env:MOONSHOT_API_KEY="sk-your-api-key-here"快速测试接口
先用最小请求确认密钥、网络和接口地址都可用。
点击位置：终端运行 curl 命令（见下方代码块）
完成后看到：返回 JSON 格式的 AI 回复，HTTP 状态码 200
- 确认 MOONSHOT_API_KEY 环境变量已设置
- 检查 Authorization 请求头格式为 Bearer sk-xxx
- 如超时，将超时时间设为 60 秒以上
- 接口地址为 https://api.moonshot.cn/v1/chat/completions
- Authorization 使用 Bearer $MOONSHOT_API_KEY
- 返回 JSON 回复即代表基础调用成功
curl -X POST https://api.moonshot.cn/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $MOONSHOT_API_KEY" \
-d '{
"model": "moonshot-v1-8k",
"messages": [
{ "role": "user", "content": "你好，请介绍一下自己" }
],
"temperature": 0.7
}'选择合适模型
按任务长度和推理需求选择模型，正式使用前先做小额测试。
点击位置：开放平台文档或控制台 → 模型列表
完成后看到：页面显示 moonshot-v1-8k/32k/128k、kimi-k2.5/k2.6 等模型信息（K2.5/K2.6 模型名称待官方确认）
- 确认模型名称拼写正确
- 首次使用建议从 moonshot-v1-8k 开始测试
- moonshot-v1-8k：适合基础对话和功能验证
- moonshot-v1-32k：适合较长文本生成与摘要
- moonshot-v1-128k：适合长文档处理和资料问答
- kimi-k2.5 / kimi-k2.6：适合深度推理、Agent 和多模态任务（模型名称待官方确认）
接入项目或客户端
Kimi 兼容 OpenAI 接口，可直接接入代码项目、Agent 框架或第三方客户端。
点击位置：项目代码中设置 api_key 和 base_url，或在客户端填写 API Key 和 API 地址
完成后看到：代码调用成功返回 AI 回复，或客户端显示连接成功
- base_url 是否为
https://api.moonshot.cn/v1 - 客户端是否选择了正确的 OpenAI 兼容接口模式
- OpenAI SDK：设置 api_key 与 base_url 后即可调用
- LobeChat 等客户端：填写 API Key、API 地址和模型名称
- OpenClaw 等 Agent 工具：按 OpenAI Provider 方式配置
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ.get("MOONSHOT_API_KEY"),
base_url="https://api.moonshot.cn/v1",
)
completion = client.chat.completions.create(
model="moonshot-v1-8k",
messages=[{"role": "user", "content": "请介绍一下 Kimi 的核心能力"}],
temperature=0.7,
)
print(completion.choices[0].message.content)排查常见问题
调用失败时，优先检查密钥、请求头、网络和频率限制。
点击位置：检查终端报错信息或控制台返回的 HTTP 状态码
完成后看到：定位到具体错误原因并修复
- 401/403：API Key 无效或过期
- 429：触发速率限制，降低并发并加入重试
- 超时：检查网络连通性并增加超时时间
- 响应异常：检查 model、messages 结构和 Content-Type
- API Key 无效：检查格式是否为 sk-xxx，并确认 Authorization 请求头为 Bearer sk-xxx
- 请求超时：把超时时间设置到 60 秒以上，并检查网络连通性
- HTTP 429：降低并发，加入延迟重试
- 响应异常：检查模型名称、messages 结构和 Content-Type
配置推荐：使用 CC Switch 接入 AI 工具
创建 API Key 后，建议用 CC Switch 统一填写 API Key、Base URL 和模型名称，再接入 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 等工具，避免手动修改配置文件出错。
使用提示
优先使用环境变量管理 MOONSHOT_API_KEY，避免密钥泄露
长文本任务优先评估 moonshot-v1-128k，实时聊天可开启流式输出
第三方客户端只要支持 OpenAI 兼容接口，通常都能接入 Kimi
注意事项
不要把 API Key 写入前端代码或公开仓库
免费额度通常有速率限制，批量任务建议做并发控制和失败重试
适合谁
- • 国内用户，想快速接入 AI API
- • 需要手把手指导完成注册、充值和获取 Key 的新手
- • 想把 月之暗面 Kimi 接入 Claude Code、Codex 等工具的用户
常见问题
月之暗面 Kimi 有免费额度吗？
有，免费额度与模型价格以控制台为准。建议先用免费额度测试真实任务，确认满足需求后再充值。
注册 月之暗面 Kimi 需要什么？
手机号或邮箱即可注册，支持支付宝/微信充值。部分 API 需要实名认证。
API Key 泄露了怎么办？
立即到控制台删除泄露的 Key 并重新生成。建议把 Key 存在环境变量或 .env 文件中，不要提交到 Git 仓库。