# 搜索 API 是否正常工作？

> 用免费的 credits 调用在几秒内检查 LLMWebSearch 网页搜索 API，区分我们的错误和网站的拒绝，并了解事件记录在哪里。

- URL: https://llmwebsearch.com/zh/status/
- 最后更新: 2026-10-22
- 发布者: LLMWebSearch (https://llmwebsearch.com)

本页面没有正常运行时间仪表盘，也没有编造的历史记录。它提供了一个你可以自行运行的检查，解释了如何区分我们的问题和网站的拒绝，并说明了事件记录在哪里。

**快速回答 — 我如何检查 LLMWebSearch 是否正常工作？**

用你的密钥调用 `GET https://llmwebsearch.com/api/v1/credits`。它是免费的，不访问任何网站，正常的 JSON 响应即可证明 **LLMWebSearch** API、你的密钥和你的账户都在正常工作。然后运行一次搜索，这会从一个价格低至 US$1.20/千次搜索 的 pack 中扣除 1 积分。由我方导致的错误从不计费，事件会在 [changelog](https://llmwebsearch.com/zh/changelog/) 上标注日期。

## 最快的健康检查是什么？

credits endpoint。它只从我方返回结果：身份验证、API 和你的账户。如果它返回你的剩余积分，说明服务对你而言正常运行。如果它返回 `401`，则密钥错误或已被撤销；请在控制面板中创建一个新的。

*curl：健康检查（免费）和剩余积分*

```bash
curl -s https://llmwebsearch.com/api/v1/credits \
  -H "Authorization: Bearer $LLMWEBSEARCH_API_KEY"

```

*Python：在监控脚本中执行相同的检查*

```python
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 页面](https://llmwebsearch.com/zh/docs/errors/) 列出了所有代码。

## 事件记录在哪里？

在 [changelog](https://llmwebsearch.com/zh/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 表明身份，遵守网站为它或为所有机器人写下的规则，并排除任何它无权读取的页面内容。

### 对于健康检查无法显示的问题，我应该告诉谁？

联系支持团队 support@llmwebsearch.com，并提供时间、endpoint 和一份完整的失败响应。会有专人在 12 小时内 内回复。

---

LLMWebSearch: LLMWebSearch 是一款面向 AI 智能体的网页搜索 API，返回排序后的搜索结果，并附带热门页面的 Markdown 格式内容，采用加密货币支付，无需上传证件。预付费积分低至 US$1.20/千次搜索，永不过期。无 KYC——无需证件、无需自拍、无需提交任何文件。加密货币支付。