메인 콘텐츠로 건너뛰기
ARouter는 서로 다른 권한을 가진 두 가지 API 키 유형을 사용합니다:
키 유형접두사목적
표준 API 키lr_live_...LLM 추론, 모든 /v1/* 엔드포인트
관리 API 키lr_admin_...키 관리, /api/v1/keys/* 엔드포인트만
관리 키는 /v1/chat/completions 또는 기타 추론 엔드포인트를 호출할 수 없습니다. 표준 키는 다른 키를 관리할 수 없습니다.

관리 API 키 생성

  1. ARouter 대시보드로 이동
  2. 새 키 클릭
  3. 관리 키 유형 선택
  4. 키 복사 — 한 번만 표시됩니다

사용 사례

관리 키는 다음 용도로 설계되었습니다:
  • 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..."}

키 객체 참조

필드유형설명
hashstring고유 키 식별자(안전하게 저장 가능, 키 자체가 아님)
namestring참조용 내부 이름
labelstring대시보드에 표시되는 레이블
created_atstringISO 8601 생성 타임스탬프
last_used_atstringISO 8601 마지막 사용 타임스탬프
usage.prompt_tokensinteger누적 프롬프트 토큰
usage.completion_tokensinteger누적 완성 토큰
usage.costnumberUSD 누적 비용
limit_usdnumber|null지출 한도. null = 무제한
rate_limit.requests_per_minuteinteger|nullRPM 제한. null = 무제한
allowed_modelsstring[]|null모델 허용 목록. null = 모든 모델 허용
allowed_providersstring[]|null제공업체 허용 목록. null = 모든 제공업체 허용

자동 키 교체

관리 키를 사용한 무중단 키 교체에 대한 전체 가이드는 API 키 교체를 참조하세요.

관련 문서