创建 ROUTER API 密钥接口

为咏唱引擎 ROUTER 创建一个新的 API 密钥。一次性返回完整密钥值，请妥善保管。可选的作用域用于限制权限。

使用创建密钥接口为访问咏唱引擎 ROUTER 生成一个新的 API 密钥。你可以指定一个便于识别的名称与一组可选的作用域。响应包含完整密钥值，且只返回这一次。你必须妥善保管；之后无法再次获取。

任何已认证调用者都可以创建密钥，但所生成密钥的权限受调用者自身作用域的约束。

接口

POST /v1/router/keys

认证

使用会话 Cookie 认证，或携带 Authorization: Bearer <api-key>。

请求体

name · string · required

新密钥的便于识别的标签。

scopes · array

要授予的权限作用域列表。省略则继承默认。

响应

id · string

唯一的密钥标识符。

name · string

分配给密钥的名称。

key · string

完整的密钥值。仅显示一次。

cURL

curl -X POST "https://router.example.com/v1/router/keys" \
  -H "Authorization: Bearer <api-key>" \
  -H "Content-Type: application/json" \
  -d '{"name":"Production pipeline","scopes":["read","write"]}'

201

{
  "id": "key_01hv8",
  "name": "Production pipeline",
  "key": "aria_9f3a4e...full-secret"
}