phaseo:web_search,模型在需要最新信息或有来源的信息时就能搜索网页。模型编写查询,并可以在一个请求中搜索多次;Phaseo 返回 URL、标题、摘要片段、高亮内容以及可选的页面文本,模型据此写出有依据的回答。
/v1/responses 和 /v1/messages 的 tools 中。
参数
模型发送的内容
每次调用都包含一个query。模型还可以发送 max_results、engine、search_context_size、域名列表、include_text、include_highlights、max_characters,以及以下本地化提示:
模型发送的值会在该次调用中替换工具的默认值。
max_results 仍受 max_total_results 剩余额度的限制;用完后,后续调用会返回 max_total_results_reached。
选择引擎
如果托管引擎未启用,调用会向模型返回
search_not_configured。
在 /v1/chat/completions 或 /v1/responses 上使用 engine: "native" 时,请求只会发往自己运行网页搜索的提供商。如果没有这样的提供商提供该模型,Phaseo 会改用默认引擎,并按托管搜索计费。
在这些接口上自己运行网页搜索的提供商有 OpenAI、/v1/responses 上的 Azure OpenAI 部署、xAI,以及 deepseek/deepseek-v4.1-flash-1017 上的 DeepSeek。只有当网页搜索是请求中唯一的工具,且没有域名列表或用户位置、没有 JSON 输出、也没有强制指定工具的 tool_choice 时,DeepSeek 才会自己搜索。它的 API 会拒绝域名列表、位置和 JSON 输出,在请求含有其他工具时关闭网页搜索,也无法强制执行搜索。发往该模型的其他请求会改用 Phaseo 的搜索,它可以与你自己的工具一起使用。开启推理后,DeepSeek 会运行更深入的搜索,分多个步骤打开并阅读页面。
发送 OpenAI 自己的 { "type": "web_search" } 工具,效果与 engine: "native" 相同。只在工具定义中设置 native:如果模型在调用中请求 native,调用会返回 unsupported_search_engine,因为提供商的工具必须在请求发送前选定。
按域名过滤
当答案必须来自一组固定来源时,使用allowed_domains;要在开放搜索中去掉特定网站时,使用 excluded_domains。
- Perplexity 只接受其中一个列表,不能同时使用,最多 20 个域名。排除的域名会以它的拒绝列表格式发送。
- Firecrawl 只接受其中一个列表,不能同时使用。
- TinyFish 两个都接受,并在查询中把它们转换为
site:和-site:运算符。 - DeepSeek 两个都接受,并把它们转换为
site:和-site:运算符。它的查询限制为 128 个字符,因此查询会被缩短,为运算符腾出空间。如果仅域名列表就超出限制,调用会返回search_query_too_long。
工具返回的内容
一个 JSON 结果,包含引擎、查询和results 数组。每条结果都有 title、url、snippet 或 highlights,在请求了页面文本且引擎提供时还有 text。
用量与价格
每次搜索都会累加到usage.server_tool_use:
server_tool_web_search_requests 和 server_tool_web_search_extra_results 设置了自己的价格,Phaseo 对每次托管搜索收取 $0.007,前 10 条之后的每条结果另收 $0.001。失败的搜索不计费;TinyFish Search 在其公开方案中免费,因此 engine: "tinyfish" 不增加搜索费用。即使模型免费,使用付费引擎搜索也需要账户有余额。原生搜索按提供商公布的价格以 native_web_search_requests 计费:例如 OpenAI 和 Anthropic 为每 1,000 次搜索 $10,DeepSeek 为每 1,000 次 $0.75,且 DeepSeek 只对返回结果的搜索计数。DeepSeek 还会对每次网页抓取(用其读取链接工具读取 URL)按每 1,000 次 $0.75 计费,计为 native_web_fetch_requests。开启推理后,DeepSeek 的一次回答可能运行十几次或更多搜索,它读取的结果会计入输入 token。