Skip to main content
POST
实测日期:2026-11-17。调用 POST https://code.heihuzi.ai/v1/responses,在 tools 里加上 {"type": "web_search"},模型就会按问题需要先联网搜索,再结合搜到的网页回答,并在回答里附上来源链接。deepseek-flash 和 deepseek-v4-pro 的非流式、流式都已实测通过。 只有 Responses 接口带 web_search 工具时才会真的搜索。 其他写法不会联网,见本页末尾“不会搜索的写法”。

请求参数

string
required
填写 deepseek-flash 或 deepseek-v4-pro。两个型号都实测搜到了网页并给出来源。
string | object[]
required
你的问题。本页示例在问题里写明“请联网搜索后回答,并附上来源链接”。
object[]
required
加入 {"type": "web_search"} 即开启联网搜索。搜不搜、搜什么由模型按问题决定。这个工具还可以带下面这些字段,每个字段都用 deepseek-flash 单独实测过效果:
integer
一次请求最多搜几轮。deepseek-flash 实测设为 1 时只搜了 1 轮;不设时同一个问题搜了 2 轮。一轮里可能带多个搜索词,按搜索词计费,所以它限制的是轮数,不是计费次数。
integer
示例使用 2048。搜索后的回答通常比普通回答长,太小可能被截断。
boolean
开启后读取 SSE,必须看到 response.completed 才算完成。

非流式完整示例

下面的脚本已在正式环境照原样运行通过:模型搜索后给出答案,打印搜索词、来源链接和本次计费的搜索次数。
把 model 换成 deepseek-v4-pro 同样可用,实测非流式和流式都正常完成。

流式完整示例

流式会依次收到 response.web_search_call.in_progress、response.web_search_call.searching、response.web_search_call.completed,然后是正文增量 response.output_text.delta、来源 response.output_text.annotation.added,最后是 response.completed。搜索次数在 response.completed 的 usage 里。

返回内容

  • web_search_call:output 里每一轮搜索有一条,status 为 completed,action.query 是这一轮用的搜索词。一轮可能有多个搜索词,用英文分号 ; 隔开,例如 北京今天天气;上海今天天气;广州今天天气。
  • 来源链接:回答正文(message 里的 output_text)的 annotations 是 url_citation 引用,每条有 title(可能为空)和 url,实测还带 site_name、publish_time、summary、logo_url。这些引用没有 start_index、end_index,不要按位置去读。
  • 搜索次数:usage.tool_usage.web_search 是本次计费的搜索次数,等于所有 web_search_call 里搜索词的总个数。上面例子里一轮用了 3 个搜索词,就计 3 次。
  • 模型可能在搜索前先输出一句“我来搜索一下”之类的话,这时 output 里有两条 message。SDK 的 output_text 会把它们连在一起。

怎么收费

  • 搜索费:每次 0.00375 元(3.75 元/千次),次数按 usage.tool_usage.web_search 算。
  • token 费:搜到的网页内容会算进输入 token,按 DeepSeek 分组的正常价格计费。实测搜一轮时输入约 2000~5500 token;问题需要多轮搜索时,输入可能超过 2 万 token。
  • 想控制费用,可以设 max_tool_calls 限制搜索轮数、max_keyword 限制每轮的搜索词个数、limit 限制每个搜索词取回的网页条数。
  • 每次请求的实际扣费以用量明细为准。用量明细的费用浮窗里,带搜索的请求会多一行“联网搜索 N 次”。

不会搜索的写法

下面这些写法都不会联网,也不收搜索费。模型只能凭自己已有的知识回答,可能告诉你它无法联网,或者给出过时的信息。 需要联网时,请改用本页的 Responses 写法。