# Kimi API：模型 ID、思考模式开关、联网搜索与 Claude Code

Source: https://ofox.ai/zh/docs/develop/models/kimi

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

## 常见任务

- [关闭思考](#thinking) — 思考默认开启，耗时较长时如何关闭。
- [联网搜索](#web-search) — Responses 接口的 web_search，返回引用来源。
- [在 Claude Code 中使用](#anthropic) — 通过 Anthropic 接口调用 Kimi。
- [报错排查](#errors) — 思考参数不支持、限流、请求超时。

## 模型
完整的模型列表与实时价格请参阅[模型页](https://ofox.ai/zh/models?provider=moonshotai)。模型 ID 的前缀为 `moonshotai/`，可省略。

**常用模型 ID（调用时原样复制）**

- Kimi K3: `moonshotai/kimi-k3` — 1M 上下文，支持图片输入
- Kimi K2.6: `moonshotai/kimi-k2.6` — 256K 上下文，支持图片输入
- Kimi K2.7 Code: `moonshotai/kimi-k2.7-code` — 面向编程

Kimi 模型由月之暗面官方（`moonshot`）提供，部分模型另有 Azure AI Foundry、阿里云百炼等供应商，默认自动选择。指定方法见[供应商路由](https://ofox.ai/zh/docs/develop/advanced/provider-routing)。

## 调用示例

**Python**

```python filename="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)
```

**cURL**

```bash filename="Terminal"
curl https://api.ofox.ai/v1/chat/completions \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "moonshotai/kimi-k3",
    "messages": [{"role": "user", "content": "用一句话解释什么是幂等性。"}],
    "thinking": {"type": "disabled"}
  }'
```

## 思考模式

**要点**: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`，模型会自行搜索并在回答中附上引用来源：

```python filename="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` 中。
- 搜索按次计费，单价见[模型页](https://ofox.ai/zh/models/moonshotai/kimi-k3)。

## 在 Claude Code 中使用
Kimi 模型支持 Anthropic 原生接口，地址为 `https://api.ofox.ai/anthropic`：

**Claude Code 配置值**

- ANTHROPIC_BASE_URL: `https://api.ofox.ai/anthropic`
- ANTHROPIC_AUTH_TOKEN: 粘贴你的 OfoxAI API Key
- ANTHROPIC_MODEL: `moonshotai/kimi-k2.7-code`

通过 Anthropic 接口调用时，思考内容以 `thinking` 块返回。Claude Code 的完整配置步骤见 [Claude Code 配置](https://ofox.ai/zh/docs/integrations/claude-code)。

## 图片输入与结构化输出
- Kimi K3、K2.6 支持图片输入，使用标准的 `image_url` 内容块，写法见[视觉理解](https://ofox.ai/zh/docs/develop/guides/vision)。
- `response_format` 支持 `json_schema` 与 `json_object`；工具调用使用标准的 `tools` 参数。写法见[结构化输出](https://ofox.ai/zh/docs/develop/guides/structured-output)。
- 自动缓存重复的请求前缀，命中量见 `usage.prompt_tokens_details.cached_tokens`。

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

其他通用错误见[错误处理](https://ofox.ai/zh/docs/develop/guides/error-handling)。

## 官方文档
- [Kimi 开放平台 · 文档](https://platform.moonshot.cn/docs)

## 常见问题

**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。