GET /voices

Lists the voices available to your API key. Use it to populate a voice picker instead of hardcoding IDs — any id it returns is valid as the voice_id of POST /launch.

GET https://agents.api.respeecher.com/voices

note

Currently, voices for other languages have a bit higher latency than the English ones.

Headers

Header	Value	Required
Authorization	Bearer <YOUR_API_KEY>	Yes

Response

200 OK — a JSON array of voice objects:

[
  { "id": "marta", "language": "en", "scales_to_zero": false },
  { "id": "ihoreo-conversation", "language": "uk", "scales_to_zero": false }
]

Field	Type	Description
id	string	The value to pass as voice_id when launching a session.
language	string	The voice's language code (en, uk, …).
scales_to_zero	boolean	The voice's TTS backend scales to zero when idle, so a session may start with extra latency while it spins back up.

The list is specific to your API key.

Errors

Status	Meaning
401 Unauthorized	Missing or invalid bearer token.

Example

curl https://agents.api.respeecher.com/voices \
  -H "Authorization: Bearer $RESPEECHER_AGENTS_API_KEY"

See also

• Available voices — the voices every valid API key can use, listed by language.