List voices and check model compatibility

GET /v1/audio/voices

Lists voices before synthesis. Pick a voice with available: true and inspect its per-model compatibility; availability alone does not guarantee compatibility with every speech model.

Guide and examplesSpeech and voice library All endpoints

Responses

200The voice library. The example shows one user voice and illustrative IDs.

voicesobject[]

idstringVoice ID, for example builtin:bright-girl or user:<uuid>.

namesobject

descriptionsobject

supported_languagesstring[]

originstringFor example cloned.

compatibilityobject[]Per-model compatibility. Availability alone does not guarantee compatibility with every speech model.

availableboolean

created_by_userbooleanOnly user voices can be deleted; built-in voices are immutable.

{
  "voices": [
    {
      "id": "user:00000000-0000-4000-8000-000000000001",
      "names": {
        "en-US": "My voice"
      },
      "descriptions": {},
      "supported_languages": [
        "en-US"
      ],
      "origin": "cloned",
      "compatibility": [],
      "available": true,
      "created_by_user": true
    }
  ]
}

401Invalid or missing API key.

403Host or origin is not allowed, or the license was rejected. Inspect error.code to tell them apart.

503A required local model is still being prepared (model_downloading) or the service is busy (service_busy). Honor Retry-After when present.