快速回答
我如何检查 LLMWebSearch 是否正常工作？
用你的密钥调用 GET https://llmwebsearch.com/api/v1/credits。它是免费的，不访问任何网站，正常的 JSON 响应即可证明 LLMWebSearch API、你的密钥和你的账户都在正常工作。然后运行一次搜索，这会从一个价格低至 US$1.20/千次搜索 的 pack 中扣除 1 积分。由我方导致的错误从不计费，事件会在 changelog 上标注日期。
最快的健康检查是什么？
credits endpoint。它只从我方返回结果：身份验证、API 和你的账户。如果它返回你的剩余积分，说明服务对你而言正常运行。如果它返回 401，则密钥错误或已被撤销；请在控制面板中创建一个新的。
curl -s https://llmwebsearch.com/api/v1/credits \
-H "Authorization: Bearer $LLMWEBSEARCH_API_KEY"
import os
import sys
import requests
resp = requests.get(
"https://llmwebsearch.com/api/v1/credits",
headers={"Authorization": f"Bearer {os.environ['LLMWEBSEARCH_API_KEY']}"},
timeout=10,
)
if resp.status_code != 200:
print("API check failed:", resp.status_code, resp.text[:200])
sys.exit(1)
print("API up, credits left:", resp.json()["credits_remaining"])
我如何区分我们的错误和网站的拒绝？
查看问题出现在响应的哪个位置。
- 整个调用出现 HTTP 错误（
502 search_failed、504 search_timeout）是我方或上游的问题。它不产生费用；稍等片刻，并以递增的延迟重试。 - 调用成功但部分结果缺少内容 是这些页面本身的问题。每个结果都带有一个
content_status：blocked_by_robots、blocked_by_site_policy、target_refused、fetch_failed或fetch_timeout。搜索本身是成功的。
第二种情况在开放网络上很常见，不算事件。errors 页面 列出了所有代码。
事件记录在哪里？
在 changelog 上。影响多个账户的事件会有一条带日期的记录：什么失败了、从何时到何时，以及之后改了什么。事件期间失败的调用未被计费，因此无需索回。
我们不公布正常运行时间百分比或延迟数据。我们更愿意给你一个可以自行运行的检查，而不是一个你无法验证的数字。
当调用失败时，我的 agent 应该怎么做？
只重试那些之后可能成功的情况。429 rate_limited、502 search_failed 或 504 search_timeout 值得在短暂等待后重试，每次等待时间翻倍。401 或 402 需要人工处理：新的密钥或更多积分。被其网站拒绝的页面根本不应重试；请改用同一次搜索的其他结果。
状态相关问题
credits 调用会消耗任何积分吗？
不会。GET https://llmwebsearch.com/api/v1/credits 是免费的，因此监控任务可以在每分钟限额允许的范围内任意频繁地运行它。
我的搜索成功了，但有一个结果没有内容。这是服务中断吗？
不是。那个页面无法读取：它的 content_status 说明了原因。我们的读取器遵守 robots.txt：它会以 LLMWebSearch 表明身份，遵守网站为它或为所有机器人写下的规则，并排除任何它无权读取的页面内容。
对于健康检查无法显示的问题，我应该告诉谁？
联系支持团队 [email protected]，并提供时间、endpoint 和一份完整的失败响应。会有专人在 12 小时内 内回复。