Skip to Content

Kimi 系列

月之暗面的 Kimi 模型,包括 Kimi K3、K2.6 与面向编程的 K2.7 Code。通过 OpenAI 兼容接口调用,同时支持 Anthropic 原生接口,可在 Claude Code 中使用。

常见任务

模型

完整的模型列表与实时价格请参阅模型页 。模型 ID 的前缀为 moonshotai/,可省略。

常用模型 ID(调用时原样复制)
Kimi K3moonshotai/kimi-k31M 上下文,支持图片输入
Kimi K2.6moonshotai/kimi-k2.6256K 上下文,支持图片输入
Kimi K2.7 Codemoonshotai/kimi-k2.7-code面向编程

Kimi 模型由月之暗面官方(moonshot)提供,部分模型另有 Azure AI Foundry、阿里云百炼等供应商,默认自动选择。指定方法见供应商路由。

调用示例

kimi_basic.py
import os from openai import OpenAI client = OpenAI(base_url="https://api.ofox.ai/v1", api_key=os.environ["OFOX_API_KEY"]) resp = client.chat.completions.create( model="moonshotai/kimi-k3", messages=[{"role": "user", "content": "用一句话解释什么是幂等性。"}], extra_body={"thinking": {"type": "disabled"}}, ) print(resp.choices[0].message.content)

思考模式

要点Kimi 默认开启思考。不需要思考时,请将 thinking 的 type 设为 disabled(K2.7 Code HighSpeed 除外)。
模型默认关闭思考
Kimi K3、K2.6、K2.7 Code开启"thinking": {"type": "disabled"}
Kimi K2.7 Code HighSpeed开启不支持,传入 disabled 返回 400

实测同一道数学题:Kimi K3 默认约 30 秒,关闭思考后约 3 秒;K2.6 默认思考约 1.1 万 token、耗时约 4.5 分钟,关闭思考后约 40 秒。思考 token 按输出单价计费,数量见 usage.completion_tokens_details.reasoning_tokens。

读取思考内容:流式响应中位于 delta.reasoning_content;非流式响应中位于 message.reasoning_details,请将各项的 text 依次拼接。

在 Responses 接口的 tools 中加入 web_search,模型会自行搜索并在回答中附上引用来源:

kimi_web_search.py
import os from openai import OpenAI client = OpenAI(base_url="https://api.ofox.ai/v1", api_key=os.environ["OFOX_API_KEY"]) resp = client.responses.create( model="moonshotai/kimi-k3", tools=[{"type": "web_search"}], input="Python 最新的稳定版本是多少?", ) print(resp.output_text) for item in resp.output: if item.type == "message": for part in item.content: for a in getattr(part, "annotations", None) or []: print("来源:", a.title, a.url)
  • 实测 Kimi K3 与 K2.6 支持。output 中依次出现 reasoning、web_search_call 与 message 条目,引用来源位于 message 内容的 annotations 中。
  • 搜索按次计费,单价见模型页 。

在 Claude Code 中使用

Kimi 模型支持 Anthropic 原生接口,地址为 https://api.ofox.ai/anthropic:

Claude Code 配置值
ANTHROPIC_BASE_URLhttps://api.ofox.ai/anthropic
ANTHROPIC_AUTH_TOKEN粘贴你的 OfoxAI API Key
ANTHROPIC_MODELmoonshotai/kimi-k2.7-code

通过 Anthropic 接口调用时,思考内容以 thinking 块返回。Claude Code 的完整配置步骤见 Claude Code 配置。

图片输入与结构化输出

  • Kimi K3、K2.6 支持图片输入,使用标准的 image_url 内容块,写法见视觉理解。
  • response_format 支持 json_schema 与 json_object;工具调用使用标准的 tools 参数。写法见结构化输出。
  • 自动缓存重复的请求前缀,命中量见 usage.prompt_tokens_details.cached_tokens。

常见报错

HTTP · type报错原文原因处理方法
400 invalid_request_errorinvalid thinking: only type=enabled is allowed for this modelK2.7 Code HighSpeed 不支持关闭思考删除 thinking 参数,或改用 K2.7 Code
429 rate_limit_errorRate limit reached for the requested model. Please retry after a short delay.请求过于频繁稍后重试,见速率限制
404 model_not_foundModel 'moonshotai/kimi-k9' not found模型 ID 拼写错误,或使用了 moonshot/ 前缀前缀为 moonshotai/,从本页复制模型 ID
请求超时—默认开启思考,复杂问题耗时较长关闭思考、使用流式输出,或将客户端超时设置为 600 秒以上

其他通用错误见错误处理。

官方文档

常见问题

Kimi 的模型 ID 怎么写?

标准写法为 moonshotai/kimi-k3,也可以省略前缀写成 kimi-k3。写成 moonshot/kimi-k3 会返回 404。

Kimi 怎么关闭思考?

传 "thinking": {"type": "disabled"},OpenAI SDK 中放在 extra_body 里。K2.7 Code HighSpeed 不支持关闭,传入会返回 400。

Kimi 能联网搜索吗?

能。使用 Responses 接口,在 tools 中加入 {"type": "web_search"},回答中会附上引用来源。实测 Kimi K3 与 K2.6 支持。

Claude Code 能用 Kimi 吗?

能。ANTHROPIC_BASE_URL 设为 https://api.ofox.ai/anthropic,模型填 moonshotai/kimi-k2.7-code 或 moonshotai/kimi-k3。

Kimi K2.6 为什么这么慢?

K2.6 默认开启思考,复杂问题可能思考上万 token、耗时数分钟。不需要思考时请关闭,或改用 Kimi K3。

最后更新于