Kimi K3 API 入门：首个请求与计费、推理强度与工具调用、接入 Claude Code 和 Codex
按 Kimi API 开放平台官方文档（2026-10 版）：用 curl、Python、JavaScript 调通 kimi-k3 并看懂计费与限速，掌握 reasoning_effort、流式思考、JSON Schema 和多轮工具调用，再让 Claude Code 与 Codex 直连 Kimi K3，并用上下文缓存降低成本。
入门·3 课时·67 分钟·图文实操
免费学习无需登录
你将学会
- 用 curl 与 Python、JavaScript 调通 kimi-k3
- 看懂 401、404、429 等常见报错并快速排错
- 按输入、输出和缓存命中估算调用费用
- 用 reasoning_effort 调节 K3 的推理强度
- 用 JSON Schema 与工具调用写出可运行的 Agent 循环
- 让 Claude Code 和 Codex 直连 Kimi K3
适合谁
- 想用 Kimi K3 搭建应用或智能体的开发者
- 想把 Claude Code、Codex 换成国产模型的工程师
- 从 moonshot-v1 或 K2 系列迁移过来的团队
课前准备
- 会用终端与基本命令行
- 本机 Python 3.9+，第 3 课需 Node.js 18+
- Kimi 开放平台账号并充值至少 10 元
课程目录
3 课时 · 67 分钟- 01拿到 key 跑通 kimi-k3：curl、Python、JavaScript、报错与计费认清 kimi-k3 等四个在售模型，创建 API key 并充值，用 curl、Python、JavaScript 各发一次请求，查模型列表与余额，并看懂报错、计费和限速。图文20 分钟开始本课
- 02推理强度、流式思考、JSON Schema 与多轮工具调用对比 low、high、max 三档推理强度，流式读出 reasoning_content，原样回传 assistant message 做多轮对话，用 JSON Schema 拿结构化结果，再写一个多轮工具调用循环。图文25 分钟开始本课
- 03让 Claude Code 与 Codex 直连 Kimi K3，再用上下文缓存省钱用 settings.json 把 Claude Code 切到 kimi-k3[1m]，用 config.toml 让 Codex 直连 Responses API，再用脚本观察上下文缓存命中并选择 5m 或 1h TTL。图文22 分钟开始本课
课程说明
Kimi K3 是月之暗面 2026 年 7 月发布的旗舰模型：2.8 万亿参数、原生视觉理解、100 万 token 上下文，面向长程编程和知识工作，完整权重也已公开。Kimi API 开放平台同时兼容 OpenAI 与 Anthropic 两种格式，改一个 base_url 就能把现有应用、Claude Code 或 Codex 切到 K3。K3 始终开启思考，用 reasoning_effort 调推理强度，这一点和 K2.x 的 thinking 参数不同，旧教程里的 moonshot-v1、kimi-k2.5 等模型也已全部下线。
本课完全按 Kimi API 开放平台官方文档整理，代码与官方示例一致；报错输出在 2026-10-23 实测，需要余额的部分使用官方文档给出的示例响应作对照。共 3 课时：
| 课时 | 你会做完的事 | 需要什么 |
|---|---|---|
| 1 | 创建 key 并充值，用 curl、Python、JavaScript 跑通 kimi-k3，查模型列表与余额，看懂报错、计费和限速 | Kimi 开放平台账号，充值至少 10 元 |
| 2 | 对比三档推理强度，流式读出思考过程，正确拼接多轮对话，用 JSON Schema 拿结构化结果，写多轮工具调用循环 | 同上 |
| 3 | 让 Claude Code 和 Codex CLI 直连 Kimi K3，用脚本观察上下文缓存命中，并在 5m 与 1h 两档 TTL 之间做选择 | 同上，外加 Node.js 18+ |
适合：想用 Kimi K3 搭建应用或智能体的开发者，以及想把 Claude Code、Codex 换成国产旗舰模型的工程师。
先修：会用终端；本机有 Python 3.9+；第 1 课的 JavaScript 部分与第 3 课需要 Node.js 18+。
官方来源：
- 快速开始：https://platform.kimi.com/docs/get-api-key
- 模型列表：https://platform.kimi.com/docs/models
- Kimi K3 模型指南：https://platform.kimi.com/docs/guide/kimi-k3-quickstart
- 模型推理价格说明：https://platform.kimi.com/docs/pricing/chat
- 推理强度：https://platform.kimi.com/docs/guide/use-reasoning-effort
- 思考模型：https://platform.kimi.com/docs/guide/use-thinking-models
- 结构化输出：https://platform.kimi.com/docs/guide/response_format
- 工具调用：https://platform.kimi.com/docs/guide/use-kimi-api-to-complete-tool-calls
- 在 Claude Code 中使用 Kimi：https://platform.kimi.com/docs/guide/claude-code-kimi
- 在 Codex 中使用 Kimi K3：https://platform.kimi.com/docs/guide/codex-kimi
- 上下文缓存最佳实践：https://platform.kimi.com/docs/guide/context-caching
绑定工具： Kimi（/tools/kimi/）· 开放平台 https://platform.kimi.com/