ARouter は異なる権限を持つ 2 種類の 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 キーローテーション を参照してください。
関連ドキュメント