接口
认证
使用会话 Cookie 认证，或携带Authorization: Bearer <api-key>。
请求体
string
required
新密钥的名称，便于识别。
array
要授予的权限作用域。省略则沿用默认值。
响应
string
密钥 id。
string
密钥名称。
string
完整的密钥值。仅显示一次。
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"]}'
{
"id": "key_01hv8",
"name": "Production pipeline",
"key": "aria_9f3a4e...full-secret"
}
密钥、成本与重放
创建 ROUTER API 密钥接口
为咏唱引擎 ROUTER 创建新的 API 密钥。完整密钥值只返回一次，请妥善保管；作用域可选，用于限制权限。
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"]}'
{
"id": "key_01hv8",
"name": "Production pipeline",
"key": "aria_9f3a4e...full-secret"
}
创建一个访问咏唱引擎 ROUTER 的 API 密钥。指定一个名称，作用域可选。响应里返回完整密钥值，只返回这一次，之后拿不到，请自己保存好。
任何已登录调用者都能创建密钥，但新密钥的权限不会超出调用者自己的作用域。
Was this page helpful?