Kimi API 购买与接入教程
从平台注册、创建密钥到完成首次调用的精简流程
✓ 国内直连✓ OpenAI 兼容接口✓ 超长上下文✓ 客户端集成方便
1
准备账号与环境
先准备好开放平台账号和本地调用环境，云端 API 不需要额外硬件。
- 进入 platform.moonshot.cn 或 platform.kimi.ai
- 使用手机号或企业邮箱注册并登录
- 本地调试建议准备 Python 3.10+ 或 Node.js 环境
2
创建并保存 API Key
在用户中心进入 API Keys 页面，新建密钥后立即保存。
- 点击「创建新密钥」或「Create New Key」
- 填写应用名称，例如 my-first-api
- 复制生成的 sk-xxx 密钥，并配置到环境变量
bash
export MOONSHOT_API_KEY="sk-your-api-key-here"
# Windows PowerShell
$env:MOONSHOT_API_KEY="sk-your-api-key-here"⚠ API Key 通常只显示一次，不要写进前端代码、公开仓库或截图里。
3
快速测试接口
先用最小请求确认密钥、网络和接口地址都可用。
- 接口地址为 https://api.moonshot.cn/v1/chat/completions
- Authorization 使用 Bearer $MOONSHOT_API_KEY
- 返回 JSON 回复即代表基础调用成功
bash
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
}'4
选择合适模型
按任务长度和推理需求选择模型，正式使用前先做小额测试。
- moonshot-v1-8k：适合基础对话和功能验证
- moonshot-v1-32k：适合较长文本生成与摘要
- moonshot-v1-128k：适合长文档处理和资料问答
- kimi-k2.5 / kimi-k2.6：适合深度推理、Agent 和多模态任务
⚠ 模型列表、免费额度和价格可能变化，购买前以开放平台控制台为准。
5
接入项目或客户端
Kimi 兼容 OpenAI 接口，可直接接入代码项目、Agent 框架或第三方客户端。
- OpenAI SDK：设置 api_key 与 base_url 后即可调用
- LobeChat 等客户端：填写 API Key、API 地址和模型名称
- OpenClaw 等 Agent 工具：按 OpenAI Provider 方式配置
python
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)6
排查常见问题
调用失败时，优先检查密钥、请求头、网络和频率限制。
- API Key 无效：检查格式是否为 sk-xxx，并确认 Authorization 请求头为 Bearer sk-xxx
- 请求超时：把超时时间设置到 60 秒以上，并检查网络连通性
- HTTP 429：降低并发，加入延迟重试
- 响应异常：检查模型名称、messages 结构和 Content-Type
使用提示
优先使用环境变量管理 MOONSHOT_API_KEY，避免密钥泄露
长文本任务优先评估 moonshot-v1-128k，实时聊天可开启流式输出
第三方客户端只要支持 OpenAI 兼容接口，通常都能接入 Kimi
注意事项
不要把 API Key 写入前端代码或公开仓库
免费额度通常有速率限制，批量任务建议做并发控制和失败重试