DeepSeek、Kimi API 怎么联网搜索：模型名加 :online 一行改完，Codex 的 web_search 也能用

在不墨 Router 上，把模型名后面加上 :online，比如 deepseek/deepseek-flash:online，模型就会先搜一次网页再回答，回答末尾自动附上来源链接。 其他代码不用改，Key 和地址都还是原来的。每次搜索 ¥0.005，搜不到不收费，token 费照常按模型价格算。

用 Codex CLI 的话，打开 Codex 自己的联网开关（codex --search）就行，它发出的 web_search 工具会由 Router 真正执行，不会再被丢掉。

还没有 Key：到 router.bumo.cc/user/api-keys 注册并创建一把。国内直连，按人民币计费。

为什么国内模型的 API 默认不能联网

DeepSeek、Kimi 等模型的 Chat API 只根据你发过去的消息作答，知识停在训练截止日期。网页版能联网，是因为网页版在模型外面加了一层搜索。直接调 API 时，这层要自己写：调搜索接口、挑结果、拼进提示词、再把来源整理给用户。

Router 的 :online 把这一层做在了网关里。你只改模型名，剩下的由 Router 完成。

一行改法

curl

curl https://router.bumo.cc/v1/chat/completions \
  -H "Authorization: Bearer $BUMO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek/deepseek-flash:online",
    "messages": [{"role": "user", "content": "今天 AI 行业有什么新闻？"}]
  }'

Python（OpenAI SDK）

from openai import OpenAI

client = OpenAI(base_url="https://router.bumo.cc/v1", api_key="你的 Router Key")

resp = client.chat.completions.create(
    model="kimi/kimi-k3:online",   # 原来是 kimi/kimi-k3，只加了 :online
    messages=[{"role": "user", "content": "今天 AI 行业有什么新闻？"}],
)
print(resp.choices[0].message.content)

流式输出（stream: true）同样支持，来源列表会在回答结束前作为最后一段内容发出。

Router 上的其他 Chat 模型也能这样加，例如 deepseek/deepseek-v4-pro:online、qwen/qwen3.8-flash:online。模型列表见 router.bumo.cc/models。

实测回答长什么样

下面是 deepseek/deepseek-flash:online 的一次真实回答（问题是「今天 AI 行业有什么新闻」，测试日期 2026-11-06，线上 router.bumo.cc，回答较长，这里节选）：

以下是根据检索到的最新报道整理的 AI 行业动态。这些报道主要集中在 11 月 3—4 日，严格来说属于"最近几天"的消息，暂时没有看到 11 月 6 日当天独有的重大新闻：

1. 乌镇峰会：AI 的讨论重心转向"应用落地" 2026 年世界互联网大会乌镇峰会于 11 月 3 日开幕。在"国家人工智能应用中试基地展"上，浙江展示了医疗、地球科学、具身智能等 6 个方向的中试基地……[1]

3. 个人 AI 助理赛道升温：Today AI 累计融资超 2 亿美元 ……报道称，个人 AI 助理在海外正成为继 AI Coding 之后受追捧的应用方向。[2][4]

来源：

1. 这些展板里，藏着AI发展"下一站"的答案（k.sina.com.cn）
2. 国内个人AI助理初创Today AI累计融资超2亿美元（news.qq.com）
3. 从连接效率到智能普惠，在乌镇看见AI如何服务于人｜新京报评论（news.qq.com）
4. 个人AI助理受追捧 Today AI完成超2亿美元融资（finance.sina.com.cn）
5. 国家金融监督管理总局副局长肖远企：AI泡沫长期可被市场消化……（finance.eastmoney.com）

值得注意的是，模型会如实说明搜到的报道是哪几天的，不会把前几天的新闻硬说成「今天」。

几点说明：

• 正文里的 [1] [3] [4] 对应末尾的来源编号，来源在实际响应里是可点击的 Markdown 链接。
• 响应的 message.annotations 里同时有 5 条 url_citation，格式和 OpenRouter 一致，程序里可以直接读链接、标题和摘要，不用解析正文。
• kimi/kimi-k3:online 同一个问题也测过，回答同样带编号引用和 5 条来源。

Codex CLI：web_search 不再被丢掉

Codex CLI 每次请求都会带一个 web_search 工具。以前通过兼容接口接国产模型时，上游没有这个能力，这个工具只能丢掉，模型就不会联网。

现在 Router 的 Responses 接口会自己执行它：先搜一次，再把结果交给模型回答，回答里带 url_citation 引用。

要注意，Codex 默认的 web_search 是缓存模式，不是实时联网。Router 没有缓存索引，缓存模式下不搜、不扣费。要实时联网，用下面任一种方式打开：

codex --search

或者写进 ~/.codex/config.toml：

model = "deepseek/deepseek-flash"
model_provider = "bumo"
web_search = "live"

[model_providers.bumo]
name = "Bumo Router"
base_url = "https://router.bumo.cc/v1"
env_key = "BUMO_API_KEY"
wire_api = "responses"

Codex 接 Router 的完整步骤见 Router 的接入中心，也可以用 magpie 一键接入。

自己调 Responses API 时也一样，在 tools 里放 {"type": "web_search"} 即可：

curl https://router.bumo.cc/v1/responses \
  -H "Authorization: Bearer $BUMO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kimi/kimi-k3",
    "tools": [{"type": "web_search"}],
    "input": "今天 AI 行业有什么新闻？"
  }'

价格

• 搜索费：每次 ¥0.005，也就是 1000 次 5 元。这是上游 DeepSeek Search 的成本价，Router 不加价。
• 搜不到不收费：搜索失败、超时或没有结果时，不收搜索费。
• token 费照常：搜到的结果会作为上下文发给模型，这部分输入 token 按模型价格计费。比如 deepseek/deepseek-flash 高峰价输入 2 元、输出 8 元每百万 token，非高峰半价。
• 账单分开：钱包流水里，搜索费单独一行，显示为「联网搜索」，和模型的 token 费分开。

搜索怎么工作（用之前值得知道的细节）

• 每次请求只搜一次，用最后一条用户消息当搜索词（超过 128 字会截断），取前 5 条结果。不做多轮反复搜索。
• 搜索失败不报错：搜索服务出问题时，模型照常直接回答，不会让整个请求失败。响应头 x-bumo-web-search 写明这次的情况：ok; results=5 表示搜到 5 条，empty 表示没搜到，failed; timeout 表示超时。
• 工具调用续写不搜：如果最后一条消息是工具执行结果（不是用户发的），这一轮不搜也不扣费，避免 Agent 每走一步就搜一次。
• 防网页注入：搜到的网页内容会明确标记为第三方资料，模型被要求只当参考、不执行其中的指令。
• Anthropic 接口暂不支持：Claude Code 走的是 /v1/messages，:online 在这个接口下不生效。要联网请用 Chat 或 Responses 接口。

常见问题

要另外申请 DeepSeek 的搜索 Key 吗？ 不用。一把 Router Key 就够，搜索费从 Router 余额里扣。

能不能只对部分请求联网？ 能。:online 是按请求生效的，同一个程序里，需要联网的请求加后缀，不需要的保持原模型名，不会额外收费。

怎么确认这次真的搜了？ 看响应头 x-bumo-web-search，或者看回答末尾有没有「来源：」列表。钱包流水里也会出现一行「联网搜索」。

海外用户呢？ 国际站 router.bumo.ai 同样支持 :online，按美元计费，每次搜索 $0.0008。