跳轉到主要內容
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())
有效的 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限額重置時間(dailyweeklymonthly 或 null)
limit_remaining金鑰被封鎖前剩餘的點數
usage歷史累計消耗的點數
usage_daily / _weekly / _monthly目前 UTC 週期的使用量
is_free_tier帳戶是否曾購買點數

免費方案限制

ID 以 :free 結尾的模型無需購買點數即可使用,但受以下限制:
條件RPMRPD
未購買付費點數20 次/分鐘50 次/天
已購買至少 $5 的點數20 次/分鐘1,000 次/天
免費方案限制僅適用於免費模型變體(後綴 :free)。付費模型需要點數餘額。

DDoS 防護

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

餘額為負

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

單金鑰消費限額

您可以在個別 API Key 上設定消費限額以控制成本:
  • 限額:金鑰可消耗的最大點數
  • 重置間隔dailyweeklymonthlynever
透過金鑰管理 API 在建立或更新金鑰時設定限額。

模型特定限制

某些高需求模型可能有獨立於帳戶總配額的額外單模型速率限制。如果在特定模型上遇到 429 Too Many Requests 錯誤,請考慮:
  • 使用 :floor:nitro 變體以存取不同的服務商端點
  • 指定有序的候選模型清單以將負載分散到多個模型
  • 在用戶端實作指數退避和重試邏輯
請參閱錯誤處理了解重試最佳實務。