> ## 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.

# 관리 API 키

> 관리 API 키는 ARouter 관리자 작업 전용 별도 자격 증명입니다 — API 키 생성, 목록 조회, 삭제에 사용합니다. LLM 추론에는 사용할 수 없습니다.

ARouter는 서로 다른 권한을 가진 두 가지 API 키 유형을 사용합니다：

| 키 유형         | 접두사            | 목적                            |
| ------------ | -------------- | ----------------------------- |
| **표준 API 키** | `lr_live_...`  | LLM 추론, 모든 `/v1/*` 엔드포인트      |
| **관리 API 키** | `lr_admin_...` | 키 관리, `/api/v1/keys/*` 엔드포인트만 |

관리 키는 `/v1/chat/completions` 또는 기타 추론 엔드포인트를 호출할 수 없습니다. 표준 키는 다른 키를 관리할 수 없습니다.

## 관리 API 키 생성

1. [ARouter 대시보드](https://arouter.ai/keys)로 이동
2. **새 키** 클릭
3. **관리 키** 유형 선택
4. 키 복사 — 한 번만 표시됩니다

## 사용 사례

관리 키는 다음 용도로 설계되었습니다：

* **CI/CD 파이프라인** — 배포 시 애플리케이션 키 교체
* **키 프로비저닝 서비스** — 사용자 또는 테넌트별 키 생성
* **관리 스크립트** — 미사용 키 감사 또는 정리
* **Terraform / 인프라스트럭처 코드** — 키 수명 주기 관리

## 키 관리 엔드포인트

모든 관리 엔드포인트에는 관리 API 키가 필요합니다：

### 키 목록

```bash theme={null}
curl https://api.arouter.ai/api/v1/keys \
  -H "Authorization: Bearer lr_admin_xxxx"
```

```json theme={null}
{
  "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}
    }
  ]
}
```

### 키 생성

```bash theme={null}
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"]
  }'
```

**응답：**

```json theme={null}
{
  "key": "lr_live_xxxx...",
  "hash": "def456...",
  "name": "staging-app"
}
```

<Note>
  `key` 값은 생성 시 **단 한 번만** 반환됩니다. 안전하게 보관하세요 — 나중에 다시 가져올 수 없습니다.
</Note>

### 키 업데이트

```bash theme={null}
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
  }'
```

### 키 삭제

```bash theme={null}
curl -X DELETE https://api.arouter.ai/api/v1/keys/{key_hash} \
  -H "Authorization: Bearer lr_admin_xxxx"
```

```json theme={null}
{"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 키 교체](/ko/guides/administration/api-key-rotation)를 참조하세요.

## 관련 문서

* [키 관리](/ko/guides/key-management) — 대시보드에서 키 관리
* [API 키 교체](/ko/guides/administration/api-key-rotation) — 자동 교체 전략
* [가드레일](/ko/guides/features/guardrails) — 키에 제한 및 정책 설정