Skip to main content
POST
联网搜索 Pro
在联网搜索 Basic 的基础上,支持通过 sites 将结果约束在指定站点内(多个站点按 OR 处理,最多 5 个),通过 time_window 约束结果的时间范围,并为每个结果返回结构化正文片段(chunks),适用于对信息来源和时效有要求的检索场景。 time_windowstartend 支持 YYYYYYYY-MMYYYY-MM-DD 三种格式,均按周期第一天归一化后比较,start 不得晚于 end
chunks 外,以上字符串字段在无数据时返回空字符串。响应示例
通用响应头以上两个响应头在所有响应(包括错误响应)中均会携带。
计费说明:请求成功(HTTP 200)且 search_results 非空时,计费一次;请求失败或未返回结果时不计费。具体价格详见联网搜索定价

授权

Authorization
string
header
必填

Authorization 请求头需要一个 Bearer 令牌。使用 MOONSHOT_API_KEY 作为令牌。这是一个服务端密钥,请在 API 密钥页面 生成。

请求体

application/json
text_query
string
必填

搜索查询文本,不能为空。

timeout_seconds
integer

搜索超时时间,单位秒,取值范围 1-60。不传则不设置单独超时。

必填范围: 1 <= x <= 60
limit
integer
默认值:5

最多返回结果数,默认 5,取值范围 1-20。

必填范围: 1 <= x <= 20
sites
string[]

站点约束,多个站点按 OR 处理,最多 5 个;单条不能为空,且不能包含空白字符或括号。

Maximum array length: 5
time_window
object

历史时间窗约束。start 与 end 均按周期第一天归一化后比较,start 不得晚于 end。

响应

搜索结果(含正文片段)

search_results
object[]
必填

搜索结果列表;无结果时为空数组。