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

# 請求頻率限制

> 每個金鑰的請求限制及回傳限制狀態的標頭。

限制以**每個 API 金鑰**為單位計算。所有已認證的端點共用以下時間窗口：

| 時間窗口 | 限制        |
| ---- | --------- |
| 每分鐘  | 60 個請求    |
| 每小時  | 1,000 個請求 |

建立匯出的成本較高，因此 `POST /exports` 每個金鑰額外有**每小時 5 個請求**的限制。

## 請求頻率限制標頭

每個已認證的回應都會回報目前的限制狀態：

| 標頭                      | 說明                    |
| ----------------------- | --------------------- |
| `X-RateLimit-Limit`     | 目前時間窗口的請求上限           |
| `X-RateLimit-Remaining` | 目前時間窗口的剩餘請求數          |
| `X-RateLimit-Reset`     | 時間窗口重置時的 Unix 時間戳記（秒） |

## 超過限制時

API 回傳 `429` 及代碼 `rate_limited`，並附上 `Retry-After` 標頭（可重試前的等待秒數）：

```json theme={null}
{
  "success": false,
  "error": "Rate limit exceeded",
  "code": "rate_limited",
  "request_id": "req_..."
}
```

等待至 `Retry-After` 時間過後再重試。建議的用戶端行為是採用指數退避並遵守 `Retry-After` 的值。

## 每個回應皆可追蹤

除了請求頻率限制標頭外，每個回應還包含：

| 標頭              | 說明                          |
| --------------- | --------------------------- |
| `X-Request-ID`  | 唯一請求識別碼——在提交支援請求時請附上此值      |
| `X-API-Version` | 處理此請求的 API 版本（`2026-07-01`） |