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 오류가 발생할 수 있습니다. 잔액을 0 이상으로 복구하기 위해 크레딧을 추가하면 접근이 복원됩니다.
키별 소비 한도
개별 API Key에 소비 한도를 설정하여 비용을 관리할 수 있습니다:
- 한도: 키가 소비할 수 있는 최대 크레딧
- 재설정 간격:
daily, weekly, monthly, 또는 never
키 관리 API를 통해 키를 생성하거나 업데이트할 때 한도를 설정합니다.
모델별 제한
일부 고수요 모델은 계정의 전체 할당량과 독립적인 추가 모델별 속도 제한을 가질 수 있습니다. 특정 모델에서 429 Too Many Requests 오류가 발생하면 다음을 고려하세요:
:floor 또는 :nitro 변형을 사용하여 다른 제공업체 엔드포인트에 접근- 부하를 모델 전반에 분산시키기 위해 순서가 있는 후보 모델 목록 지정
- 클라이언트에 지수 백오프 및 재시도 로직 구현
재시도 모범 사례에 대해서는 오류 처리를 참조하세요. 
