> ## 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](/jp/api-reference/keys/create-key) を使用してキーを作成または更新する際に制限を設定します。

## モデル固有の制限

一部の高需要モデルは、アカウントの全体的なクォータとは独立した追加のモデルレート制限を持つ場合があります。特定のモデルで `429 Too Many Requests` エラーが発生した場合は、以下を検討してください：

* `:floor` または `:nitro` バリアントを使用して異なるプロバイダーエンドポイントにアクセスする
* 複数のモデルに負荷を分散させるため、順序付きの候補モデルリストを指定する
* クライアントに指数バックオフとリトライロジックを実装する

リトライのベストプラクティスについては[エラーハンドリング](/jp/guides/error-handling)を参照してください。