Kimi 3 API（Kimi K3）：开发者需要知道什么

对 Kimi 3 API 的搜索量正在上升，但官方模型名称是 Kimi K3。当你查找文档、配置 SDK 或选择模型标识符时，这个命名细节很重要：API 模型 ID 是 kimi-k3，而不是 kimi-3。

截至 2026 年 7 月 23 日，Moonshot AI 已通过 Kimi API Platform 提供 Kimi K3。官方文档将其描述为一款拥有原生视觉理解能力、参数规模达 2.8 万亿、上下文窗口为 1,048,576 tokens 的旗舰模型。它可以通过与 OpenAI 兼容的接口调用，Moonshot 还表示完整模型权重将于 2026 年 7 月 27 日 发布。

本指南会区分哪些内容已经确认、哪些内容仍需持续关注，展示 Kimi K3 API 的基础设置，并说明如何为 Kimi K3 以及下一次快速迭代的模型发布做好应用准备，而无需每次都重建集成。

Kimi 3 还是 Kimi K3：哪个名称才正确？

Kimi K3 是官方名称。“Kimi 3”是一个自然的搜索词，但 Moonshot AI 的发布页面、API 平台、文档和模型 ID 都使用 Kimi K3。

请在合适的地方使用这些术语：

• 搜索和科普文案：“Kimi 3 API (Kimi K3)”可以帮助读者将常见查询与官方产品名称对应起来。
• API 请求：在 model 字段中使用 kimi-k3。
• 技术文档：在首次说明命名差异后，优先使用“Kimi K3”。

这样可以避免一个常见的发布周问题：把非官方模型名称复制进代码里，并误以为报错就意味着 API 不可用。

关于 Kimi K3 API，哪些内容已确认？

以下细节已在 Moonshot AI 于 2026 年 7 月 23 日发布的官方材料中确认：

Moonshot 官方 Kimi K3 定价页面目前列出的价格为：每一百万 tokens，缓存命中输入 $0.30、缓存未命中输入 $3.00、输出 $15.00，不含适用税费。请将这些数字视为时效性较强的信息，并在预算或发布固定对比之前再次查看官方定价页面。

官方发布材料还包含基准测试和架构方面的说法。这些内容是评估的有用起点，但团队应当使用自己的提示词、工具、延迟要求和输出审查标准来复现测试，而不是把发布图表当作生产决策依据。

如何直接访问 Kimi K3 API

Moonshot 提供了 OpenAI 兼容的设置，因此已经在使用 OpenAI SDK 的开发者可以通过不同的 API 密钥和基础 URL 初始化客户端。

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["MOONSHOT_API_KEY"],
    base_url="https://api.moonshot.ai/v1",
)

response = client.chat.completions.create(
    model="kimi-k3",
    messages=[
        {
            "role": "user",
            "content": "Summarize the main risks in this migration plan.",
        }
    ],
    reasoning_effort="low",
)

print(response.choices[0].message.content)

OpenAI 兼容并不意味着每个模型的行为都完全相同。Kimi K3 有特定于模型的规则。根据当前文档，其思考模式始终开启，若干采样参数是固定的，并且不支持公开图片 URL 作为视觉输入。在将现有生产工作负载原样迁移之前，请先查看 K3 的参数限制。

为什么 OpenAI 兼容 API 很有帮助——但不是全部策略

OpenAI 兼容 API 减少了集成中的机械性工作。你的应用通常可以保留相同的客户端库和请求结构，只需更改基础 URL、API 密钥和模型名称。

但传输层兼容并不能消除模型之间的运营差异：

• 支持的请求参数可能不同；
• 结构化输出行为需要回归测试；
• 工具调用的 schema 和工具选择规则可能会有所不同；
• 推理会影响延迟和 token 消耗；
• 上下文限制并不保证长文档性能相同；
• 速率限制和可用性可能会因账户层级而变化；
• 多模态输入要求可能因提供方而异。

更稳妥的方法是将产品代码与提供方特定访问分离。你的应用应调用一个稳定的模型访问层，而路由策略、提供方凭证、回退机制、配额和使用报告则保留为核心功能之外的可配置项。

为 Kimi K3 和下一次模型发布做好应用准备

快速的模型发布会带来两个不同的任务：评估 和 迁移。把它们合并成一次紧急代码改动，会让两者都更难。

1. 保持 API 接口稳定

在应用中使用一个 OpenAI 兼容的客户端边界，而不是把提供方 SDK 初始化分散到整个代码库中。稳定的基础 URL 可以让你更轻松地添加或替换受支持的模型，而无需重写每个功能。

Flatkey 为受支持的模型提供一个 API key 和 OpenAI 兼容的 base URL https://router.flatkey.ai/v1。其公开的实时目录在 2026 年 7 月 23 日检查时显示 kimi-k3 可用。

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["FLATKEY_API_KEY"],
    base_url="https://router.flatkey.ai/v1",
)

response = client.chat.completions.create(
    model="kimi-k3",
    messages=[
        {"role": "user", "content": "Review this implementation plan."}
    ],
)

在部署之前，务必确认当前的模型目录和参数支持情况。可用性、路由配置和定价在发布后都可能发生变化。

2. 按工作负载路由，而不是按模型热度

不要在发布第一天就把所有流量都发送到新模型。请定义如下评估类别：

• 仓库级代码处理；
• 文档分析；
• 使用工具的代理；
• 结构化数据提取；
• 图像或视频理解；
• 低延迟客户聊天。

然后针对每个类别测试质量、延迟、token 消耗和失败行为。某个模型可能非常适合长周期代码任务，但对于短分类调用来说并非必要。

3. 在生产流量到来之前定义模型回退

模型回退策略不应只回答“如果 Kimi K3 宕机了该运行什么？”它还应定义：

1. 哪些备用模型支持相同的输入模态；
2. 必须移除或转换哪些请求参数；
3. 备用模型是否保留结构化输出和工具调用；
4. 可接受的最大成本和延迟；
5. 何时应明确失败，而不是返回一个置信度较低的答案。

Flatkey 的路由和自动切换能力让团队能够通过一个集成来管理受支持的上游路由。随着模型可用性的变化，应用程序可以保持稳定的 API 边界，而路由策略则可以演进。

4. 集中跟踪使用情况并执行配额

新模型可能会同时改变平均 token 消耗和输出长度。集中化的使用跟踪有助于工程和财务团队判断一次实验是在改进产品，还是仅仅在增加支出。

Flatkey 将使用可见性、统一计费、API key 管理和配额控制整合在一个仪表板中。当多个团队在 Kimi K3 之外还测试 GPT、Claude、Gemini、DeepSeek、Qwen 或其他受支持模型时，这一点尤其有用。

直接使用 Kimi API 还是多模型 AI 网关？

这两种方式都可能成立。

当你希望尽可能直接地使用 Moonshot 特有能力、能够接受管理另一个供应商账户，并且计划围绕 Kimi 当前的 API 行为进行深度优化时，选择 直接使用 Kimi AI API。

当你的应用需要比较模型、在不进行大范围代码修改的情况下切换路由、配置回退、集中使用报告，或在多个供应商之间控制团队配额时，选择 多模型 AI 网关。

这个选择不一定是永久性的。一个干净的、与 OpenAI 兼容的边界，可以让团队同时测试直连和网关路径，同时保持应用层相对稳定。

有关实现细节，请阅读 Flatkey 的 OpenAI-compatible API gateway migration checklist，然后查看更全面的 AI API gateway architecture guide。

Kimi K3 评估清单

在将生产流量路由到 Kimi K3 之前，请确认：

• 可用的确切模型 ID 和路由；
• 当前输入、输出和缓存定价；
• 账户层级的速率限制和并发；
• 所需的 reasoning_effort 行为；
• 工具调用和结构化输出兼容性；
• 多模态文件和 URL 限制；
• 在真实上下文大小下的延迟；
• 在速率限制或提供方错误下的回退行为；
• 用量、计费和配额可见性；
• 在你自己的验收集上的输出质量。

一百万 token 的上下文窗口是一项重要能力，但它不能替代针对特定工作负载的测试、可观测性和成本控制。

FAQ

Kimi 3 和 Kimi K3 是同一个吗？

“Kimi 3”是常见的搜索说法，而 Kimi K3 是官方模型名称。API 模型 ID 请使用 kimi-k3。

Kimi K3 API 现在可用吗？

是的。截至 2026 年 7 月 23 日，Kimi K3 已在官方 Kimi API Platform 中有文档说明并可用。Flatkey 的实时公开模型目录在当天也列出了 kimi-k3 可用。

Kimi K3 API 与 OpenAI 兼容吗？

Moonshot 表示，Kimi API 使用与 OpenAI 兼容的格式。开发者可以使用 OpenAI SDK 搭配 Moonshot 的 base URL 和 API key，同时需要注意 K3 特定的参数规则。

Kimi K3 的上下文窗口是多少？

官方文档列出的上下文窗口为 1,048,576 个 token，通常被描述为一百万 token。

我可以在 Kimi K3 中关闭推理吗？

不可以。当前文档说明 Kimi K3 始终启用思考。你可以将 reasoning_effort 调整为 low、high 或 max。

为什么要为 Kimi K3 使用 AI API 网关？

AI API 网关可以保持一个面向应用的 API 边界，同时集中管理受支持模型访问、路由、回退、用量跟踪、计费和配额控制。当模型和可用性快速变化时，这会减少运维工作量。

为模型变化而构建，而不只是针对单一模型

Kimi K3 是开发者在评估长上下文、多模态、编程和知识工作负载时的一个重要新选项。更大的架构启示是，模型访问将继续变化。

Flatkey 可帮助团队通过一个 API 密钥、一个与 OpenAI 兼容的基础 URL，以及一个控制台访问受支持的模型，用于路由、用量、计费和配额管理。下一次模型评估前，查看当前的模型目录和定价。