跳轉到主要內容
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累計提示 token
usage.completion_tokensinteger累計補全 token
usage.costnumber累計費用（美元）
limit_usdnumber|null消費限額。null = 不限制
rate_limit.requests_per_minuteinteger|null每分鐘請求數限制。null = 不限制
allowed_modelsstring[]|null模型白名單。null = 允許所有模型
allowed_providersstring[]|null服務商白名單。null = 允許所有服務商

​
自動密鑰輪換

請參閱 API 密鑰輪換 取得使用管理密鑰進行零停機密鑰輪換的完整指南。

​
相關文件