ARouter 實施速率限制以確保公平存取並保護服務可用性。建立更多帳戶或 API Key 不會增加速率限制 — 容量按帳戶全域管理。
查看目前限制
若要查看 API Key 的速率限制或剩餘點數,請向 /v1/key 發起 GET 請求:
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 變體以存取不同的服務商端點
- 指定有序的候選模型清單以將負載分散到多個模型
- 在用戶端實作指數退避和重試邏輯
請參閱錯誤處理了解重試最佳實務。