Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
管理 API 密鑰是專門用於 ARouter 管理員操作的獨立憑證 — 用於建立、列出和刪除 API 密鑰。不能用於 LLM 推理。
| 密鑰類型 | 前綴 | 用途 |
|---|---|---|
| 標準 API 密鑰 | lr_live_... | LLM 推理，所有 /v1/* 端點 |
| 管理 API 密鑰 | lr_admin_... | 密鑰管理，僅限 /api/v1/keys/* 端點 |
/v1/chat/completions 或其他推理端點。標準密鑰不能管理其他密鑰。
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 | 累計提示 token |
usage.completion_tokens | integer | 累計補全 token |
usage.cost | number | 累計費用（美元） |
limit_usd | number|null | 消費限額。null = 不限制 |
rate_limit.requests_per_minute | integer|null | 每分鐘請求數限制。null = 不限制 |
allowed_models | string[]|null | 模型白名單。null = 允許所有模型 |
allowed_providers | string[]|null | 服務商白名單。null = 允許所有服務商 |