轮换 API Key
PUT /api/v1/gateway/keys/{key_id}/rotate
生成一把新 Key 替换旧 Key。旧 Key 在宽限期内仍然可用，便于平滑切换。完整新 Key 仅在本次响应中返回一次。需要管理员及以上角色（admin / ops / super）。
鉴权：本接口属于控制台后端 API（Base URL
https://portal.aiin1.ai，注意不是api.portal.aiin1.ai），需携带控制台账号登录后获取的access_token（15 分钟有效），不能使用sk-nex-API 令牌。登录方式见 账单对账与用量自动同步。
请求参数
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
key_id |
path | string(uuid) | 是 | Key ID |
请求示例
curl -X PUT https://portal.aiin1.ai/api/v1/gateway/keys/KEY_ID/rotate \
-H "Authorization: Bearer $ACCESS_TOKEN"响应
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
new_key_id |
string(uuid) | 是 | 新 Key ID |
new_key |
string | null | 否 | 完整新 Key，仅此一次返回 |
new_key_prefix |
string | 是 | 新 Key 前缀 |
old_key_id |
string(uuid) | 是 | 旧 Key ID |
old_key_grace_until |
string(datetime) | 是 | 旧 Key 失效时间（宽限期截止） |
message |
string | 否 | 提示信息 |