2026 年 7 月 16 日,月之暗面发布了 Kimi K3,2.8 万亿参数的 MoE 架构、100 万 token 上下文窗口、原生多模态,各项指标直追 Claude Fable 5 和 GPT-5.6 Sol,简直夯爆了。K3前脚刚刷屏,后脚就宣布暂停新订阅。

原来发布 48 小时内,用户请求量远超预估,算力不够了。7 月 19 日,月之暗面宣布暂停 C 端新用户的会员订阅。
已订阅的用户不受影响,但新用户只能另找办法。API 成了最直接的替代路径。K3 模型已经在 Kimi 开放平台上线,模型 ID 为 kimi-k3,按量付费,不需要订阅。只要有 API Key,再做少量配置,就能把 K3 的能力接到本地开发环境中。
问题是,API 调用和官方客户端之间的差距,远比想象中大。
Kimi K3 API 调用前的准备
注册与充值
使用 Kimi K3 的 API 需要先在 Kimi 开放平台 注册账号并创建 API Key。注意,Kimi 开放平台的速率限制(RPM、TPM、并发数)是按累计充值金额分级的。
免费账户的请求配额极低。在实际测试中,免费账户发送一条最基础的请求,返回的不是结果,而是 engine_overloaded_error,直到累计充值达到一定金额、账户升级到更高的 Tier 后,同样的请求才返回 HTTP 200。
也就是说API 接口虽然开放,但算力资源有限的情况下,平台会优先保障高 Tier 用户的请求。充值不是万能的,但不充值确实很难用。
Kimi K3 的 API 定价
| 计费项 | 价格(每百万 Tokens) |
| 输入(缓存未命中) | $3.00 |
| 输入(缓存命中) | $0.30 |
| 输出 | $15.00 |
K3 的输出定价在主流模型中属于较高水平。系统会自动对重复上下文进行缓存,缓存命中的输入成本可降低 90%。但在实际使用场景中,上下文变化频繁,缓存命中率并不稳定,需要注意用量控制。
四种接入方式横向对比
为了观察同一个模型在不同使用方式下的实际表现,以下分别测试了四种接入方式。测试任务是提供一张网页截图,要求模型理解页面的视觉语言并重建为可运行的 HTML 文件。

方式一:K3 API 直连
直连是链路最短的方式。在终端中运行一段脚本,将参考图编码后连同提示词一起发送给 K3 API,要求返回包含 HTML、CSS 和 JavaScript 的单文件网页。
# 环境变量配置示例
export KIMI_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxx"
export KIMI_API_BASE="https://api.moonshot.cn/v1"直连最明显的特征是没有过程反馈。请求发出后,终端只显示一行提示,然后是长时间的沉默。因为采用非流式模式,模型是在理解图片、思考布局还是已经开始生成代码,完全看不到。整个过程像是一次黑盒等待。
但直连反而是最早交付结果的。生成完成后,输出的 HTML 文件可以直接在浏览器中打开。K3 抓住了参考图中克制的版式、大面积留白、衬线字体这些视觉特征,页面整体具有一致的设计语言。不过没有达到像素级还原,部分元素的尺寸、位置和图片内容与参考存在差异。
直连的优势在于:没有额外的 Agent 系统上下文,没有复杂的工具调用链,模型只需要集中完成一次生成任务。对于明确的、一次性的代码生成需求,直连比完整的编程 Agent 更高效。
方式二:K3 接入 Claude Code
Claude Code 可以通过 Anthropic 兼容接口,将请求转发到 Kimi K3。配置方式如下:
# 将 Claude Code 的请求转发到 Kimi K3
export ANTHROPIC_BASE_URL="https://api.moonshot.cn/v1"
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxxxxxxxxxxxxxx"
export ANTHROPIC_MODEL="kimi-k3"配置完成后,Claude Code 的文件读写、终端执行和 Agent 工作流依然可用,但底层模型换成了 K3。
接入 Claude Code 后,体验立刻不同。模型可以读取参考图、检查目录结构、规划文件组织、生成代码,还能运行终端命令。整个过程有明确的步骤反馈,不再是一段沉默的等待。
然而问题也随之出现。第一轮生成结束后,Claude Code 返回了大量代码,却没有将页面写入本地文件。只有在被明确要求检查磁盘上实际创建了哪些文件后,它才发现前面的代码生成并没有转化为文件操作,随后补齐了文件创建步骤。
这是 Agent 产品中一个典型的问题:Agent 外壳在扩展模型能力的同时,也扩大了故障面。模型不仅要生成正确代码,还要正确选择工具、构造参数、理解执行反馈,并在最后验证输出。任何一环出错,都可能产生一种"已经完成了"的错觉。
另外还需要注意的是,参考图和 API 直连版都使用接近纯白的背景,而 Claude Code 版本染上了一层淡暖红色调。这可能是随机性导致的,也可能与 Claude Code 自身的系统提示有关。
方式三:Kimi 官方客户端
使用 Kimi 官方原生客户端(Web 或 App),相同的任务完成得更细致。官方客户端在幕后做了大量工作:系统提示词经过调优、工具编排经过设计、文件管理和错误恢复流程都是现成的。这些都不会随着 API Key 一起暴露给第三方调用者。
在测试中,官方客户端对参考图的风格还原更加贴近,并且在字体选择上做了一些符合自身产品风格的调整。
方式四:Codex(GPT-5.6 Sol)
原计划将 K3 通过 CC Switch 接入 Codex,但请求始终停留在本地转换层的 502 错误。最终完成对比的是 Codex 自己的 GPT-5.6 Sol。
Codex 的还原度接近一比一,页面布局和间距的精确度明显高于其他方式。这一组对比更适合作为外部基准参考。
四种方式的对比总结
| 维度 | API 直连 | Claude Code + K3 | Kimi 官方客户端 | Codex (GPT-5.6 Sol) |
| 首次交付速度 | 最快 | 中等 | 中等 | 较慢 |
| 是否可直接运行 | 是 | 首次未落盘,需人工干预 | 是 | 是 |
| 风格还原度 | 较好 | 存在色调偏移 | 好 | 非常好 |
| 过程可观测性 | 无 | 有完整步骤反馈 | 有 | 有 |
| 后续修改能力 | 无 | 可持续迭代 | 可持续迭代 | 可持续迭代 |
同一个模型,不同的 Harness,不同的结果

这次测试说明了一个问题,模型名称相同,不代表产品行为相同。
同一个 K3 模型,在 API 直连和 Claude Code 中呈现出不同的视觉风格、不同的工作流程,甚至不同的错误模式。这种差异来自 harness(运行外壳)。
API 直连的话,模型在单次生成中形成统一方案,从头写到尾。Claude Code 则更像一个分阶段项目,先理解截图,再规划结构,然后写文件、补样式、加交互、启动服务。每多一个步骤,就多一次模型重新解释任务的机会,也多一次风格漂移的可能。
官方客户端本身也是一种 harness。只是当模型公司自己提供系统提示、工具、记忆和 Agent 循环时,人们通常称之为"产品";第三方团队用类似方式组织模型时,则被叫作"套壳"。
但 harness 并不是被动包装。它在组织能力的同时,也在制造能力,当然也在制造新的故障。K3 接入 Claude Code 后获得了读写文件和运行终端的能力,同时也出现了未落盘、色调偏移等新问题。
这带出了一个更深层的判断标准:一个产品是否有价值,不在于它有没有调用别人的模型,而在于模型之外,它究竟创造了多少使用价值。成熟的 harness 需要决定模型如何理解任务、能操作哪些工具、怎样拆解步骤、如何保存状态、什么时候检查结果,以及失败后怎样恢复。
API 调用的实际成本与隐性门槛
通过 API 使用 K3,除了模型调用的 token 费用,还有几项隐性成本需要考虑。
协议兼容问题。 Kimi 开放平台提供的是与 OpenAI / Anthropic 兼容的接口,但兼容并不意味着完全一致。不同 Agent 工具对请求格式、流式响应、工具调用协议的实现存在差异。在实测中,将 K3 通过 CC Switch 接入 Codex 时,请求始终返回 502,根本原因就在于两端协议格式的细微差异。这类问题如果每个客户端工具各自处理,排查成本很高。但 ServBay AI Gateway 就可以解决,它是在网关层集中维护各家模型的协议适配,Claude Code 和 Codex 只需对接 Gateway 的统一接口,不必关心上游模型用的是 Messages API 还是 Responses API,协议转换的工作由 Gateway 一次性完成。
速率限制。 免费账户的 RPM(每分钟请求数)和 TPM(每分钟 Token 数)极低,在编码场景下很容易触发 rate_limit_reached_error。即便升级到 Tier-1,在复杂任务中仍然需要注意请求频率。
环境配置。 API Key 管理、环境变量配置、本地脚本编写、响应解析,这些工作全部由用户自行承担。对于不熟悉终端操作和 Python 脚本的用户来说,上手门槛不低。
给不同场景的建议
| 用户类型 | 推荐方式 | 原因 |
| 有明确代码生成需求的开发者 | API 直连 | 链路最短,成本可控,适合单次生成任务 |
| 需要模型读写项目文件、持续迭代的开发者 | Claude Code + K3 | 有完整的 Agent 工作流,支持多轮修改 |
| 不熟悉 API 配置的普通用户 | 等待官方订阅恢复 | 官方客户端的体验最完整,上手门槛最低 |
| 同时使用多家模型 API 的开发者 | 本地 AI Gateway 方案 | 集中管理 API Key,统一接入,按需切换模型 |
当 API Key 越来越多,管理本身也成了问题

通过这次折腾 K3,我发现了,大家手里的 API Key 越来越多。
用 Kimi K3 写前端,用 Claude 做逻辑推理,用 GPT 跑长文本,用本地 Ollama 模型处理隐私敏感数据。每个模型对应一个 API Key,散落在不同项目的环境变量和配置文件里。换一个模型就要改一遍配置,月底对账时根本分不清哪个项目花了多少钱。
更麻烦的是安全问题。API Key 一旦泄露,别人可以直接用来消费余额,而且很难及时发现。
那怎么解决API Key的问题?通过 ServBay AI Gateway 就可以。在本地运行一个网关服务,将所有模型的 API Key 集中管理,对外只暴露一个统一入口。Claude Code、Cursor 等编程工具接入 Gateway 后,切换模型不需要修改任何配置,所有请求经过 Gateway 路由,用量和花费在一张仪表盘上一目了然。

和 OpenRouter 等云端聚合方案不同的是,本地 Gateway 的 API Key 不离开本机,不经过第三方服务器。对于 API Key 安全性要求较高的场景,本地方案的隐私优势比较明显。

当然,Gateway 不解决算力紧张的问题。K3 的 engine_overloaded_error 来自模型服务端,和客户端用什么方式接入无关。Gateway 解决的是 API Key 分散管理、多模型切换、用量追踪这些日常运维层面的效率问题。
总结
Kimi K3 暂停新用户订阅后,API 确实是一条可用的替代路径。但 API 调用和官方客户端之间的差距,远不只是一个 Base URL 的区别。
官方客户端中调好的系统提示、工具编排、文件管理、错误恢复和交付流程,不会随着 API Key 一起交到用户手上。通过 API 迁移出来的,是模型的推理和生成能力。而稳定性、协议兼容、运行环境和最终验收,这些责任都转移到了用户自己身上。
对于愿意投入配置时间的开发者,API 搭配 Claude Code 等 Agent 工具,可以构建一个相当灵活的工作流。对于普通用户,等待官方恢复订阅可能仍然是成本最低的选择。
不论哪种方式,大模型生态正在从"选一个最好的模型"转向"管理好手里的多个模型"。API Key 管理、模型切换、用量控制这些基础设施层面的需求,会随着模型数量的增长持续放大。
