Kimi 系列
月之暗面的 Kimi 模型,包括 Kimi K3、K2.6 与面向编程的 K2.7 Code。通过 OpenAI 兼容接口调用,同时支持 Anthropic 原生接口,可在 Claude Code 中使用。
常见任务
模型
完整的模型列表与实时价格请参阅模型页 。模型 ID 的前缀为 moonshotai/,可省略。
moonshotai/kimi-k31M 上下文,支持图片输入moonshotai/kimi-k2.6256K 上下文,支持图片输入moonshotai/kimi-k2.7-code面向编程Kimi 模型由月之暗面官方(moonshot)提供,部分模型另有 Azure AI Foundry、阿里云百炼等供应商,默认自动选择。指定方法见供应商路由。
调用示例
Python
import os
from openai import OpenAI
client = OpenAI(base_url="https://api.ofox.io/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 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,模型会自行搜索并在回答中附上引用来源:
import os
from openai import OpenAI
client = OpenAI(base_url="https://api.ofox.io/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.io/anthropic:
https://api.ofox.io/anthropicmoonshotai/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。
常见报错
其他通用错误见错误处理。
官方文档
常见问题
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.io/anthropic,模型填 moonshotai/kimi-k2.7-code 或 moonshotai/kimi-k3。
Kimi K2.6 为什么这么慢?
K2.6 默认开启思考,复杂问题可能思考上万 token、耗时数分钟。不需要思考时请关闭,或改用 Kimi K3。