跳到导航

文章正文被截断,能让 AI 继续猜后面的内容吗?

不能。POST /v1/web/read 返回 truncated: true 时,严禁让 AI 猜测或补全被截断的后半部分。只输出 results[].content 中已有依据的结论,把缺失条款标记为待核,再发起新的 Read 请求补读剩余内容。

精确补读缺失段落

可通过两个参数控制单条 URL 的返回内容:

  • max_chars:单条 URL 返回字符上限,范围 500–100,000(默认 20,000)。长文档或更新日志提前截断时,可调高上限。
  • query:最长 400 字符的可选问题串,只返回与目标问题相关的段落(例如已读到迁移日期、还缺旧版停用条件时,专门检索停用条件段落)。
curl -sS https://api.beatapi.io/v1/web/read \
-H "Authorization: Bearer $BEATAPI_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"urls":["https://example.com/migration"],"query":"旧版 API 停用条件","max_chars":12000}'

理解携带 query 时的 truncated: false

传入 query 后,truncated: false 仅表示抽取出的相关段落没有超出 max_chars 上限,不代表返回了整篇网页全文。每次补读都按独立请求计费(每条成功读取 URL $0.002)。

合同与相关问题

执行前免费检查对应合同:data:web.search, data:web.read, data:web.map。

返回Web Search问题索引。