メインコンテンツへスキップ
ARouter は異なる権限を持つ 2 種類の 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 キーローテーション を参照してください。

関連ドキュメント