接口
认证
使用会话 Cookie 认证，或携带Authorization: Bearer <api-key>。
请求体
string
required
新密钥的便于识别的标签。
array
要授予的权限作用域列表。省略则继承默认。
响应
string
唯一的密钥标识符。
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?