web_search 工具,让 GPT 系列模型搜索最新信息并返回来源引用。本页介绍调用方式、响应结构和计费规则。
接入方式
在 OneToken 中,使用 Responses API(/v1/responses),并在 tools 中添加 web_search 即可启用联网搜索。默认分组的 API Key 即可使用,无需额外开通。
模型表现参考
以下为原文记录的 2026 年 6 月 11 日测试数据,供选型参考。搜索次数、延迟和 token 用量会随问题与搜索结果变化。快速上手
将示例中的YOUR_ONETOKEN_API_KEY 替换为你的 OneToken API Key。
cURL
Python(OpenAI SDK)
响应结构说明
output 数组按执行顺序包含:
status 为 completed 表示响应已完成。如果返回 incomplete,请检查 incomplete_details;若原因为输出 token 达到上限,可以调大 max_output_tokens 后重试。
计费说明
联网搜索费用包括工具调用费和检索内容 token 费:原文测试中的单次问答开销参考:gpt-5.4 约为 $0.01 搜索费加 9k input token 费用;gpt-5.5 约为 $0.08 搜索费加 50k input token 费用。实际费用请以 OneToken 当前计费规则和调用账单为准。
注意事项
- 使用 Responses API 和
web_search工具:gpt-5 系列模型不支持 Chat Completions 的web_search_options参数,使用该参数会返回 400Unknown parameter: 'web_search_options'。该参数用于*-search-preview专用模型。 - 建议将
max_output_tokens设置为至少 8192:该额度同时包含推理 token 和最终回答 token。上限过小时,响应可能因额度耗尽而返回status: "incomplete";即使没有最终回答,已消耗的 token 仍会计费。 - 旧版工具类型
web_search_preview同样可用,行为一致;新接入建议直接用web_search。 - 如需控制成本,可以选用 gpt-5.4,或在提示词中要求减少搜索次数,例如“最多搜索 2 次”。提示词不能保证搜索次数上限,请以实际返回的
web_search_call数量为准。
FAQ
Q:怎么确认这次回答真的联网了? A:检查响应output 中是否包含 type="web_search_call" 的条目,并查看 message 的 content[].annotations 中是否包含 url_citation。搜索调用记录和来源引用可以帮助你核对工具执行情况;不要仅凭回答正文判断是否联网。
Q:需要更换分组或使用特殊 API Key 吗?
A:不需要。你可以使用 OneToken 默认分组的 API Key 调用联网搜索。
Q:支持哪些模型?
A:本页示例使用 gpt-5.4,也可以改为 gpt-5.5。其他模型是否可用,请以 OneToken 当前支持的模型和工具能力为准,并在接入前检查搜索调用记录与来源引用。
相关文档
API 快速开始
了解 OneToken API 的基础调用方式
API 使用手册
查看 API Key、模型和调用配置说明

