ARouter는 서로 다른 권한을 가진 두 가지 API 키 유형을 사용합니다:
| 키 유형 | 접두사 | 목적 |
|---|
| 표준 API 키 | lr_live_... | LLM 추론, 모든 /v1/* 엔드포인트 |
| 관리 API 키 | lr_admin_... | 키 관리, /api/v1/keys/* 엔드포인트만 |
관리 키는 /v1/chat/completions 또는 기타 추론 엔드포인트를 호출할 수 없습니다. 표준 키는 다른 키를 관리할 수 없습니다.
관리 API 키 생성
- ARouter 대시보드로 이동
- 새 키 클릭
- 관리 키 유형 선택
- 키 복사 — 한 번만 표시됩니다
사용 사례
관리 키는 다음 용도로 설계되었습니다:
- CI/CD 파이프라인 — 배포 시 애플리케이션 키 교체
- 키 프로비저닝 서비스 — 사용자 또는 테넌트별 키 생성
- 관리 스크립트 — 미사용 키 감사 또는 정리
- Terraform / 인프라스트럭처 코드 — 키 수명 주기 관리
키 관리 엔드포인트
모든 관리 엔드포인트에는 관리 API 키가 필요합니다:
키 목록
curl https://api.arouter.ai/api/v1/keys \
-H "Authorization: Bearer lr_admin_xxxx"
{
"data": [
{
"hash": "abc123...",
"name": "production-app",
"label": "Production",
"created_at": "2026-01-01T00:00:00Z",
"last_used_at": "2026-04-01T12:00:00Z",
"usage": {"prompt_tokens": 1500000, "completion_tokens": 450000, "cost": 12.50},
"limit_usd": 100.0,
"rate_limit": {"requests_per_minute": 100}
}
]
}
키 생성
curl -X POST https://api.arouter.ai/api/v1/keys \
-H "Authorization: Bearer lr_admin_xxxx" \
-H "Content-Type: application/json" \
-d '{
"name": "staging-app",
"label": "Staging",
"limit_usd": 25.0,
"allowed_models": ["openai/gpt-5.4", "anthropic/claude-sonnet-4.6"]
}'
응답:
{
"key": "lr_live_xxxx...",
"hash": "def456...",
"name": "staging-app"
}
key 값은 생성 시 단 한 번만 반환됩니다. 안전하게 보관하세요 — 나중에 다시 가져올 수 없습니다.
키 업데이트
curl -X PATCH https://api.arouter.ai/api/v1/keys/{key_hash} \
-H "Authorization: Bearer lr_admin_xxxx" \
-H "Content-Type: application/json" \
-d '{
"label": "Staging (v2)",
"limit_usd": 50.0
}'
키 삭제
curl -X DELETE https://api.arouter.ai/api/v1/keys/{key_hash} \
-H "Authorization: Bearer lr_admin_xxxx"
{"deleted": true, "hash": "def456..."}
키 객체 참조
| 필드 | 유형 | 설명 |
|---|
hash | string | 고유 키 식별자(안전하게 저장 가능, 키 자체가 아님) |
name | string | 참조용 내부 이름 |
label | string | 대시보드에 표시되는 레이블 |
created_at | string | ISO 8601 생성 타임스탬프 |
last_used_at | string | ISO 8601 마지막 사용 타임스탬프 |
usage.prompt_tokens | integer | 누적 프롬프트 토큰 |
usage.completion_tokens | integer | 누적 완성 토큰 |
usage.cost | number | USD 누적 비용 |
limit_usd | number|null | 지출 한도. null = 무제한 |
rate_limit.requests_per_minute | integer|null | RPM 제한. null = 무제한 |
allowed_models | string[]|null | 모델 허용 목록. null = 모든 모델 허용 |
allowed_providers | string[]|null | 제공업체 허용 목록. null = 모든 제공업체 허용 |
자동 키 교체
관리 키를 사용한 무중단 키 교체에 대한 전체 가이드는 API 키 교체를 참조하세요.
관련 문서