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_TOKENvoiceId 使用列表或创建接口返回的同一 id。