查询音色列表

查询当前组织可用的自定义音色。返回音色 ID 与名称，便于在音色语音合成中选用。

列表最多返回 1000 条。源文档提到可按分页读取，当前 OpenAPI 路径未定义查询参数。

Base URL

• https://api.autorouter.top — Production

Authentication

BearerAuth: http (bearer) 使用 Bearer Token 认证。 格式: Authorization: Bearer sk-xxxxxx

Endpoints

GET /v1/audio/voice/list

查询自定义音色列表

读取已上传的自定义声音资源。

Responses

200: 查询成功

Content-Type: application/json

401: Bearer Token 无效或缺失

Content-Type: application/json

请求示例

curl -X GET "https://api.autorouter.top/v1/audio/voice/list" \
  -H "Authorization: Bearer sk-xxxxxx"

响应示例

{
  "list": [
    {
      "id": "uspeech:xxxx",
      "name": "温柔女声"
    },
    {
      "id": "uspeech:yyyy",
      "name": "沉稳男声"
    }
  ]
}

响应字段说明：

错误处理

HTTP 401 / 403 鉴权错误

• 401 Unauthorized：API Key 无效或已过期
• 403 Forbidden：API Key 无权访问此模型（检查 token 的模型白名单）

HTTP 402 余额不足

返回 insufficient user quota。请前往 AutoRouter 控制台充值。