FishSpeech Docs
API ReferenceVoices

Voices

List, create, and delete voice models.

Voices

Voice endpoints manage the voice ids used by TTS requests.

List Voices

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

Query Parameters

ParameterDescription
providerFilter by provider
searchSearch by voice name or metadata
limitPage size
offsetOffset for pagination

Response

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

Create Voice

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

Voice creation commonly uses reference audio. The exact payload depends on the enabled provider and model creation flow.

Delete Voice

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

Use the same voiceId value returned by the list or create endpoint.