批量查询服务商稳定性

这个 API 面向中转站聚合、导航和榜单网站。你可以按 slug 批量获取公开服务商的实时状态、7 天观测可用率、评分和首 token 延迟摘要。

请求

POST /api/radar/providers/query
Content-Type: application/json

{
  "slugs": ["skyhope", "example-ai"]
}

每次最多提交 20 个 slug。接口只返回已公开、已加入公共池的服务商。响应带有 ETag 和 10 分钟公共缓存，建议客户端尊重Cache-Control并使用If-None-Match减少重复请求。

响应

{
  "apiVersion": "v1",
  "generatedAt": "2026-06-29T10:00:00.000Z",
  "window": { "label": "7d" },
  "items": [
    {
      "slug": "skyhope",
      "name": "Skyhope",
      "status": "operational",
      "observedHealthScore": 96.77,
      "grade": "A",
      "confidenceLevel": "medium",
      "availability7dBasisPoints": 9677,
      "sampleCount7d": 1114,
      "p95FirstTokenMs": 6485,
      "statusPageUrl": "https://llm-hub.store/skyhope"
    }
  ],
  "missing": []
}

observedHealthScore

等于 7 天观测可用率百分数，例如 96.77。

grade

S/A/B/C/D/F/unknown，适合做列表粗筛。

confidenceLevel

high/medium/low/insufficient，表示样本可信度。

和 iframe 的区别

iframe 适合某个中转站长把自己的服务状态嵌到官网；开发者 API 适合聚合站一次查询多个服务商并自行渲染列表。两者服务的是不同用户，所以入口和文档分开。

当前接口使用 POST 请求，直接在浏览器地址栏打开不会返回查询结果。请按上面的请求示例调用。