> ## 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 は異なる権限を持つ 2 種類の 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 キーローテーション](/jp/guides/administration/api-key-rotation) を参照してください。

## 関連ドキュメント

* [キー管理](/jp/guides/key-management) — ダッシュボードからのキー管理
* [API キーローテーション](/jp/guides/administration/api-key-rotation) — 自動ローテーション戦略
* [ガードレール](/jp/guides/features/guardrails) — キーへの制限とポリシーの設定