语音TTS · 音色列表

查询当前用户创建的语音音色模型列表

<details>
<summary>基本信息</summary>

字段内容
类型应用 API
应用名称语音TTS
应用编码voice_tts
API 名称音色列表
API 编码list_voices
请求方式GET
请求路径/api/v1/apps/voice_tts/list_voices
调用模式同步

</details>

鉴权

Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

请求路径

GET /api/v1/apps/voice_tts/list_voices

业务参数

参数类型必填默认值可选值 / 范围示例说明
tagstring否———按标签筛选
titlestring否———按音色名称搜索
sort_bystring否—score / task_count / created_at—排序:score / task_count / created_at
languagestring否———按语言筛选
page_sizeinteger否———每页数量,官方默认 10
page_numberinteger否———页码,默认 1
title_languagestring否———按标题语言筛选

请求示例

{
    "tag": "string",
    "title": "string",
    "sort_by": "score",
    "language": "string",
    "page_size": 20,
    "page_number": 1,
    "title_language": "string"
}

成功响应

{
    "code": 1,
    "msg": "success",
    "data": {
        "_comment": "具体字段以接口实际返回为准"
    }
}

失败响应

{
    "error": {
        "message": "点数余额不足",
        "type": "insufficient_points",
        "code": "insufficient_points"
    }
}

错误码

HTTPcode含义
400invalid_request参数缺失或格式错误
401auth_failedAPI Key 缺失或无效
402insufficient_points点数余额不足
402key_quota_exceeded当前 API Key 点数额度不足
403permission_denied当前 API Key 无权调用该模型/应用
404not_found模型 / 应用 / 任务不存在
429queue_limit_exceeded排队任务已达上限
5xxserver_error服务异常,请稍后重试

同类文章