Kimi K3 API快速上手教程：注册手机号获取API Key（选全部权限）、用OpenAI SDK配置base_url和model、curl验证请求、VS Code中Cline设OpenAI Compatible并填三项参数、tool调用需两轮交互。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想用Kimi K3 API跑通第一个请求，但卡在注册、填参、报错三连击上——别折腾了，这篇教程只保留真正要做的动作，删掉所有“理论上应该”和“建议考虑”，直接带你从手机号输入框走到返回JSON。
注册账号并拿到可用的API Key
打开 platform.moonshot.cn，用手机号注册（不支持邮箱）。老用户直接登录，K3没单独建账号体系。
登录后点左栏「API Key 管理」→「创建新 Key」。权限范围选【全部权限】——如果只选“仅 API”，后续调用 tool 或联网功能会直接 403 报错，且无法中途补开。
弹窗出现以 sk- 开头的密钥时，立刻复制。这个明文只显示一次，关掉就再也看不到，也查不到历史记录。
复制时注意前后空格——粘贴到代码里导致 401 Unauthorized 是新手最常踩的坑。
配置调用环境：Python SDK 零改动接入
执行 pip install openai，Kimi K3 完全兼容 OpenAI SDK，不需要额外包。
写 Python 脚本时，只需把官方示例里的 base_url 和 model 替换掉：
client = OpenAI(
api_key="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
base_url="https://api.moonshot.cn/v1"
)
model 字段填 kimi-k3 即可发起标准调用；如需超长上下文分析，改用 kimi-k3-allegretto（支持 1M token）；常规开发推荐 kimi-k3-moderato（256K，响应更快）。
注意：不要把 api_key 写死在代码里。用 os.getenv("MOONSHOT_API_KEY") + 环境变量方式更安全，尤其上线后。
发第一条请求：绕过 Postman 直接用 curl 验证
打开终端，粘贴这条命令（把 YOUR_API_KEY 换成你刚复制的密钥）：
curl -X POST https://api.moonshot.cn/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "kimi-k3",
"messages": [
{"role": "user", "content": "输出 hello world，只输出这五个字符，不要任何标点或换行"}
]
}'
使用 Moonshot Kimi API 的 $web_search 内置工具进行联网搜索。当需要进行网络搜索获取实时信息时使用，支持中文和英文搜索查询。需要配置 MOONSHOT_API_KEY。
回车运行。看到 JSON 响应里 choices[0].message.content 等于 "hello world"，说明通了。
如果返回 401，检查密钥是否带空格；返回 404，确认 URL 末尾没有斜杠；返回 400，检查 JSON 格式有没有漏逗号或引号不闭合。
在 Cline 中配置 Kimi K3（VS Code 开发者专用）
第一步：点击 VS Code 左侧 Cline 图标 → 点齿轮图标进设置。
第二步：Provider 下拉框必须选【OpenAI Compatible】——不是 “OpenAI”，也不是 “Custom”，选项名就是这八个字。
第三步：按顺序填三项：
• Base URL：https://api.moonshot.cn/v1（结尾不能加 /）
• API Key：粘贴你保存的 sk-xxxx 字符串
• Model ID：kimi-k3
填完直接在聊天窗口发一句“hi”，Cline 底部状态栏出现 “Kimi K3” 并返回结果，即配置成功。
调用带 tool 的真实任务：让Kimi自动联网查今日金价
第一步：构造含 tool 的 messages 数组，声明函数为 get_gold_price，并指定 type="function"。
第二步：在 system message 里明确要求模型“必须调用工具获取实时金价，禁止自行编造数字”。
第三步：发送请求后，若返回内容含 tool_calls 字段，说明模型已识别需求；此时需你用该字段中的 function.name 和 arguments 调用对应外部接口，再把结果塞回 conversation 继续发一次。
这一步不可跳过：Kimi K3 的 tool 调用是两轮交互，第一轮它决定调什么，第二轮你提供结果，它才生成最终回复。
