创建 API Key 导读
创建 key 时，除了拿到密钥本身，也要同时确认过期时间和保存方式。
POST/v1/customer/api-keys
请求参数
| Name | Type | Required | Description |
|---|---|---|---|
name | string | Required | 给 key 一个可读名称，便于后续治理、轮换和排障。 |
expires_in_days | integer | 可选的过期天数。如果你不想让 key 永久有效，这一项应该明确设置。 |
请求示例
bash
curl -X POST https://api.therouter.ai/v1/customer/api-keys \
-H "Authorization: Bearer $THEROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "backend-prod",
"expires_in_days": 30
}'返回值
json
{
"id": "4d953cc1-b4d5-45fd-9d51-0f0a6e2ec7d8",
"name": "backend-prod",
"api_key": "sk-2F8A8OU8Q0zv0V8b5d4uQ0vR8J62m9pZ4F8Y8K0mQ2Y",
"key_preview": "a8c9X2zQ",
"expires_at": "2026-03-27T08:30:00.000Z",
"created_at": "2026-02-26T08:30:00.000Z"
}请立即保存完整 key
api_key 只会显示一次。你应该在创建返回的当下就写入 secret manager， 而不是指望之后再从列表接口里找回来。