查询音色列表

POST https://www.yuntts.com/api/v1/indextts25/voices

返回可直接使用的音色：系统音色 + 你自己创建的音色。别人的克隆音色看不到。

5.1 请求参数

参数	类型	必填	说明
`voice_source`	String	否	`official` 只看系统音色、`upload` 只看我的克隆音色；不传返回全部

5.2 返回参数

参数	类型	说明
`data.items`	Array	音色列表（系统音色在前，我的克隆音色在后）
`data.items[].voice_id`	String	音色 ID，创建任务时传给 `voice_id`
`data.items[].name`	String	音色名称
`data.items[].source`	String	`preset` 系统音色 / `custom` 克隆音色，可直接作为创建任务的 `voice_source`
`data.items[].voice_source`	String	`official` 系统 / `upload` 我的克隆
`data.items[].description`	String	音色描述
`data.items[].model`	String	所属模型
`data.items[].model_permission`	Integer	权限标记
`data.items[].audio_url`	String	试听地址（本站存储）；没有试听样例时为空字符串
`data.items[].avatar_url`	String	头像地址
`data.items[].created_at`	String	创建时间
`data.total`	Integer	音色数量
`data.source`	String	数据来源标记

{
  "code": 200,
  "message": "查询成功",
  "data": {
    "items": [
      {
        "voice_id": "01a0a95d-9255-79a5-9050-4eca1064620d",
        "name": "承泽",
        "source": "preset",
        "voice_source": "official",
        "description": "IndexTTS2.5 系统预设音色",
        "model": "IndexTTS-2.5",
        "model_permission": 1,
        "audio_url": "https://www.yuntts.com/wp-content/uploads/my-document/audio/processed/1790984194_35515870.wav",
        "avatar_url": "https://www.yuntts.com/wp-content/uploads/avatar-tss/ai.webp",
        "created_at": "2026-10-03 09:00:00"
      }
    ],
    "total": 1,
    "source": "local_database"
  }
}

5.3 错误码

HTTP	error	说明
500	`database_error`	音色查询失败，请稍后重试

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": 200,
    "message": "查询成功",
    "data": {
        "items": [
            {
                "voice_id": "音色ID",
                "name": "音色名称",
                "source": "preset",
                "voice_source": "official",
                "description": "音色描述",
                "model": "IndexTTS-2.5",
                "model_permission": 1,
                "audio_url": "试听地址",
                "avatar_url": "头像地址",
                "created_at": "2026-10-03 10:00:00"
            }
        ],
        "total": 1,
        "source": "local_database"
    }
}

查询音色列表

查询音色列表#

5.1 请求参数#

5.2 返回参数#

5.3 错误码#

请求参数

请求示例代码

返回响应

查询音色列表

5.1 请求参数

5.2 返回参数

5.3 错误码