目前服务部署在单台小机器上,全站检索约 50 次/秒、ask 约 20 个并发;请控制并发(建议 ≤ 5),收到 429 按 Retry-After 退避。 详情 →

网页

概览

开放网页上的 agentic 问答。只有 ask。

状态
live
文档 id
url 如 https://example.com/page
引用格式
[https://…]

常用调用

联网问答POST /v1/web/ask {"query": "…", "effort": "low"} → 带来源链接的答案(只有 ask,没有 search / read)

问registered key+ /stream

POST/v1/web/ask
Google 检索 + 读网页 + 带 URL 引用作答。effort low / medium / high 对应 50 / 100 / 200 credits。加 /stream 走 NDJSON,第一个事件一定是 billing。首个 answer_delta 之前失败会退款。

参数

参数类型说明
query 必填 string 1–2000 字符。问得具体;要数字就直接问数字。
search_type search · scholar · news · images= search
gl string= us Google 国家码;中文 query 自动 cn
hl string= en 搜索语言;中文 query 自动 zh-cn
effort low · medium · high= low 检索轮数,也决定价格:50 / 100 / 200 credits。套餐限制最高档。
verbose bool= false 返回工具调用轨迹(流式时多 tool_call / tool_result / thinking 事件)。
top_k integer= 10 预取候选数。
stream_answer bool= true 仅流式:false 时只发一个 answer 事件。
max_rounds integer 0–8,覆盖 effort 预设。
force_answer_after number 秒;强制切入作答阶段。
max_answer_tokens integer= 4096 触顶时置 answer_truncated。
language string 回答语言,默认跟随 query。

示例

{ "answer": "… [https://…] …", "sources": [ … ], "stats": { "rounds": 1, "elapsed_s": 6.2, "answer_truncated": false }, "coverage"?: { … }, "meta": { "credits": { "charged": 50, … } } }
引用是真的——answer 里的每个 id 都存在于本垂域(格式 [https://…])。sources 是召回集,不是引用列表。answer_truncated 表示不完整。