FishSpeech Docs
API Reference音色

音色

查询、创建和删除音色模型。

音色

音色接口用于管理 TTS 请求中使用的 voiceId

查询音色

GET /api/open/v1/voices
Authorization: Bearer YOUR_API_TOKEN

查询参数

参数说明
provider按提供商筛选
search按音色名称或元数据搜索
limit每页数量
offset分页偏移

响应

{
  "total": 1,
  "page": 1,
  "pageSize": 20,
  "totalPages": 1,
  "items": [
    {
      "id": "voice_123",
      "name": "My Voice",
      "provider": "fishaudio"
    }
  ]
}

创建音色

POST /api/open/v1/voices
Authorization: Bearer YOUR_API_TOKEN
Content-Type: multipart/form-data

创建音色通常需要参考音频。具体请求体取决于当前启用的提供商和模型创建流程。

删除音色

DELETE /api/open/v1/voices/{voiceId}
Authorization: Bearer YOUR_API_TOKEN

voiceId 使用列表或创建接口返回的同一 id。