> ## 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` 오류가 발생할 수 있습니다. 잔액을 0 이상으로 복구하기 위해 크레딧을 추가하면 접근이 복원됩니다.

## 키별 소비 한도

개별 API Key에 소비 한도를 설정하여 비용을 관리할 수 있습니다:

* **한도**: 키가 소비할 수 있는 최대 크레딧
* **재설정 간격**: `daily`, `weekly`, `monthly`, 또는 `never`

[키 관리 API](/ko/api-reference/keys/create-key)를 통해 키를 생성하거나 업데이트할 때 한도를 설정합니다.

## 모델별 제한

일부 고수요 모델은 계정의 전체 할당량과 독립적인 추가 모델별 속도 제한을 가질 수 있습니다. 특정 모델에서 `429 Too Many Requests` 오류가 발생하면 다음을 고려하세요:

* `:floor` 또는 `:nitro` 변형을 사용하여 다른 제공업체 엔드포인트에 접근
* 부하를 모델 전반에 분산시키기 위해 순서가 있는 후보 모델 목록 지정
* 클라이언트에 지수 백오프 및 재시도 로직 구현

재시도 모범 사례에 대해서는 [오류 처리](/ko/guides/error-handling)를 참조하세요.