速率限制

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

查看目前限制

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

Python
Node.js
cURL

import requests

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

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);

curl https://api.arouter.ai/v1/key \
  -H "Authorization: Bearer $AROUTER_API_KEY"

有效的 API Key 將回傳：

{
  "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 次/天

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

DDoS 防護

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

餘額為負

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

單金鑰消費限額

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

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

透過金鑰管理 API 在建立或更新金鑰時設定限額。

模型特定限制

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

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

請參閱錯誤處理了解重試最佳實務。

快速開始

核心概念

路由

功能特性

使用指南

隱私

管理

最佳實踐

框架與整合

供應商接入

幫助

查看目前限制

免費方案限制

DDoS 防護

餘額為負

單金鑰消費限額

模型特定限制

​查看目前限制

​免費方案限制

​DDoS 防護

​餘額為負

​單金鑰消費限額

​模型特定限制

查看目前限制

免費方案限制

DDoS 防護

餘額為負

單金鑰消費限額

模型特定限制