联网搜索（$web_search）除 token 费用外，每次触发还额外收取 ¥0.03 的工具调用费。即使搜索结果质量不佳，触发即计费。本文说明计费时机和避免不必要费用的方法。

Kimi 工具定价：联网搜索

价格表

工具	计费单位	价格
联网搜索（$web_search）	每次调用	¥0.03

---

费用构成

一次联网搜索实际产生两部分费用：

1. 工具调用费：¥0.03/次，触发 $web_search tool_calls 时收取
2. Token 费用：搜索结果作为上下文传入模型，搜索结果占用的 token 按模型输入价格计费

典型费用示例（kimi-k2.6）：

搜索结果：13,046 tokens → ¥0.085（按 ¥6.50/1M 计算）
工具调用：1 次 → ¥0.03
当轮总计：约 ¥0.115 + 对话 token 费用

---

计费时机

情况	是否收取 ¥0.03
模型决定调用 $web_search（finish_reason = tool_calls）	✅ 收取
用户继续对话但模型未触发搜索	❌ 不收取
工具调用失败/无结果	✅ 仍收取（触发即计费）

---

控制联网搜索成本

# 方法1：只有特定用户问题才注册 $web_search
if "最新" in user_message or "今天" in user_message:
    tools = [{"type": "builtin_function", "function": {"name": "$web_search"}}]
else:
    tools = []  # 不注册工具，模型不会搜索

# 方法2：通过 system prompt 指导模型减少不必要的搜索
system = "只有当问题明确需要最新实时信息时才搜索，静态知识问题不要搜索。"

---

常见问题

Q: 每次对话可以触发多次 $web_search 吗？

A: 是的，模型可能在一次对话中多次触发搜索（如任务需要多次查询不同关键词）。每次触发都是单独计费的 ¥0.03，多次搜索需乘以次数。

Q: 如何知道本次调用触发了几次搜索？

A: 通过响应中的 tool_calls 数量判断，每个 $web_search tool_call 计一次费。也可以在控制台的费用明细中查看工具调用历史。

Q: 用自定义搜索工具（而非 $web_search）是否也有额外费用？

A: 不会有工具调用费（¥0.03），但你需要自行支付搜索 API 的费用（如 Tavily、Bing Search API 等）。搜索结果进入模型上下文产生的 token 费用照常收取。