网页
概览
开放网页上的 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/askGoogle 检索 + 读网页 + 带 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 表示不完整。