> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hitheo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 获取基准数据

> 检索指定时间窗口内的平台整体性能基准数据。

## 查询参数

<ParamField query="window" type="string" optional>
  用于聚合的时间窗口。可选值：`24h`、`7d`、`30d`。默认值：`24h`。
</ParamField>

## 响应

<ResponseField name="window" type="string">
  所请求的时间窗口。
</ResponseField>

<ResponseField name="latency_by_mode" type="object">
  按模式统计的延迟数据：`{ [mode]: { p50, p95, p99, count } }`。
</ResponseField>

<ResponseField name="ttft_by_mode" type="object">
  按模式统计的首个令牌延迟数据（仅适用于流式）：`{ [mode]: { p50, p95, count } }`。
</ResponseField>

<ResponseField name="classification" type="object">
  意图分类延迟：`{ p50, p95, count }`。若该时间窗口内没有自动模式请求，则为 null。
</ResponseField>

<ResponseField name="counters" type="object">
  聚合计数器：`total`、`failover_count`、`routing_accuracy`、`total_tokens`、`total_cost_cents`、`by_mode`。
</ResponseField>

## 认证

需要提供 API 密钥或仪表盘会话。

## 示例

```bash curl theme={null}
curl "https://www.hitheo.ai/api/v1/benchmarks?window=24h" \
  -H "Authorization: Bearer $THEO_API_KEY"
```

### 响应

```json theme={null}
{
  "window": "24h",
  "latency_by_mode": {
    "fast": { "p50": 450, "p95": 1200, "p99": 2100, "count": 1543 },
    "code": { "p50": 890, "p95": 2400, "p99": 4100, "count": 312 }
  },
  "ttft_by_mode": {
    "fast": { "p50": 180, "p95": 450, "count": 1200 }
  },
  "classification": { "p50": 12, "p95": 310, "count": 890 },
  "counters": {
    "total": 2847,
    "failover_count": 3,
    "routing_accuracy": 0.94,
    "total_tokens": 4520000,
    "total_cost_cents": 1250,
    "by_mode": { "fast": 1543, "code": 312, "image": 201 }
  },
  "bucket": "2026-04-16T05"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.