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

# 速率限制

> ARouter API 速率限制、基於點數的配額，以及如何查看目前的限制。

ARouter 實施速率限制以確保公平存取並保護服務可用性。建立更多帳戶或 API Key **不會**增加速率限制 — 容量按帳戶全域管理。

## 查看目前限制

若要查看 API Key 的速率限制或剩餘點數，請向 `/v1/key` 發起 `GET` 請求：

<Tabs>
  <Tab title="Python">
    ```python theme={null}
    import requests

    response = requests.get(
        "https://api.arouter.ai/v1/key",
        headers={"Authorization": f"Bearer {AROUTER_API_KEY}"}
    )
    print(response.json())
    ```
  </Tab>

  <Tab title="Node.js">
    ```typescript theme={null}
    const response = await fetch("https://api.arouter.ai/v1/key", {
      headers: { Authorization: `Bearer ${process.env.AROUTER_API_KEY}` },
    });
    const keyInfo = await response.json();
    console.log(keyInfo);
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl https://api.arouter.ai/v1/key \
      -H "Authorization: Bearer $AROUTER_API_KEY"
    ```
  </Tab>
</Tabs>

有效的 API Key 將回傳：

```json theme={null}
{
  "data": {
    "label": "my-key",
    "limit": 100.0,
    "limit_reset": "monthly",
    "limit_remaining": 72.45,
    "usage": 27.55,
    "usage_daily": 2.10,
    "usage_weekly": 8.40,
    "usage_monthly": 27.55,
    "is_free_tier": false
  }
}
```

| 欄位                                     | 說明                                        |
| -------------------------------------- | ----------------------------------------- |
| `limit`                                | 此金鑰的點數限額（null = 無限制）                      |
| `limit_reset`                          | 限額重置時間（`daily`、`weekly`、`monthly` 或 null） |
| `limit_remaining`                      | 金鑰被封鎖前剩餘的點數                               |
| `usage`                                | 歷史累計消耗的點數                                 |
| `usage_daily` / `_weekly` / `_monthly` | 目前 UTC 週期的使用量                             |
| `is_free_tier`                         | 帳戶是否曾購買點數                                 |

## 免費方案限制

ID 以 `:free` 結尾的模型無需購買點數即可使用，但受以下限制：

| 條件            | RPM     | RPD       |
| ------------- | ------- | --------- |
| 未購買付費點數       | 20 次/分鐘 | 50 次/天    |
| 已購買至少 \$5 的點數 | 20 次/分鐘 | 1,000 次/天 |

<Note>
  免費方案限制僅適用於免費模型變體（後綴 `:free`）。付費模型需要點數餘額。
</Note>

## DDoS 防護

Cloudflare 的 DDoS 防護會自動攔截明顯超出合理使用模式的請求。這些攔截是暫時的，待流量恢復正常後自動解除。

## 餘額為負

如果帳戶點數餘額為負，可能會看到 `402 Payment Required` 錯誤——包括在免費模型上。加值使餘額恢復到零以上即可恢復存取。

## 單金鑰消費限額

您可以在個別 API Key 上設定消費限額以控制成本：

* **限額**：金鑰可消耗的最大點數
* **重置間隔**：`daily`、`weekly`、`monthly` 或 `never`

透過[金鑰管理 API](/zh-Hant/api-reference/keys/create-key) 在建立或更新金鑰時設定限額。

## 模型特定限制

某些高需求模型可能有獨立於帳戶總配額的額外單模型速率限制。如果在特定模型上遇到 `429 Too Many Requests` 錯誤，請考慮：

* 使用 `:floor` 或 `:nitro` 變體以存取不同的服務商端點
* 指定有序的候選模型清單以將負載分散到多個模型
* 在用戶端實作指數退避和重試邏輯

請參閱[錯誤處理](/zh-Hant/guides/error-handling)了解重試最佳實務。