v1

latestOpenAPI 3.0.1ZHIPU AI 开发者协议和政策2026-07-2649130210.9 KB

工具 API

网络搜索

Web Search API 是一个专给大模型用的搜索引擎，在传统搜索引擎网页读取、排序的能力基础上，增强了意图识别能力，返回更适合大模型处理的结果（网页标题、URL、摘要、名称、图标等）。支持意图增强检索、结构化输出和多引擎支持。见网络搜索服务。点击 Try it 按钮可快速试用。

post/paas/v4/web_search

Request body

search_querystring required

需要进行搜索的内容，建议搜索 query 不超过 70 个字符。

search_engine'search_std' | 'search_pro' | 'search_pro_sogou' | 'search_pro_quark' required

要调用的搜索引擎编码。目前支持： search_std：智谱基础版搜索引擎 search_pro：智谱高阶版搜索引擎 search_pro_sogou：搜狗 search_pro_quark：夸克搜索

search_intentboolean required

是否进行搜索意图识别，默认不执行搜索意图识别。 true：执行搜索意图识别，有搜索意图后执行搜索 false：跳过搜索意图识别，直接执行搜索

countinteger

返回结果的条数。可填范围：1-50，最大单次搜索返回50条，默认为10。支持的搜索引擎：search_pro_sogou、search_std、search_pro search_pro_sogou: 可选枚举值，10、20、30、40、50。注意同时指定 search_domain_filter 和 search_recency_filter 时 count 不生效。

search_domain_filterstring

用于限定搜索结果的范围，仅返回指定白名单域名的内容。白名单域名:（如 www.example.com）支持的搜索引擎：search_std、search_pro 、search_pro_sogou

search_recency_filter'oneDay' | 'oneWeek' | 'oneMonth' | 'oneYear' | 'noLimit'

搜索指定时间范围内的网页。默认为 noLimit。可填值：oneDay（一天内）、oneWeek（一周内）、oneMonth（一个月内）、oneYear（一年内）、noLimit（不限，默认）。支持的搜索引擎：search_std、search_pro、search_pro_Sogou、search_pro_quark

content_size'medium' | 'high'

控制返回网页内容的长短。medium：返回摘要信息，满足大模型的基础推理需求，满足常规问答任务的信息检索需求。high：最大化上下文，信息量较大但内容详细，适合需要信息细节的场景。支持的搜索引擎：search_std、search_pro、search_pro_Sogou、search_pro_quark

request_idstring

请求唯一标识符。由用户端传递，ID长度要求：最少6个字符，最多64个字符，建议使用UUID格式确保唯一性，若未提供平台将自动生成。

user_idstring

终端用户的唯一ID，帮助平台对终端用户的非法活动、生成非法不当信息或其他滥用行为进行干预。ID长度要求：至少6个字符，最多128个字符。

Example request

{
  "search_engine": "search_std"
}

Response

业务处理成功

idstring

任务 ID

createdinteger

请求创建时间，是以秒为单位的 Unix 时间戳

request_idstring

请求标识符