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"
{
"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 バリアントを使用して異なるプロバイダーエンドポイントにアクセスする- 複数のモデルに負荷を分散させるため、順序付きの候補モデルリストを指定する
- クライアントに指数バックオフとリトライロジックを実装する
リトライのベストプラクティスについてはエラーハンドリングを参照してください。 
