Voices API

List the voices your API key can synthesize with. The result is exactly the set of voice_id values POST /v1/tts accepts for your key: the public premade catalog plus your organization’s own voice clones.


GET https://api.revolab.ai/v1/voices

No request parameters. Authenticate with your API key as a Bearer token.

Request examples

cURL


curl https://api.revolab.ai/v1/voices \
  -H "Authorization: Bearer $REVOLAB_API_KEY"

Python


import os
import requests
 
response = requests.get(
    "https://api.revolab.ai/v1/voices",
    headers={"Authorization": f"Bearer {os.environ['REVOLAB_API_KEY']}"},
)
response.raise_for_status()
for voice in response.json()["voices"]:
    print(voice["voice_id"], voice["language"], voice["type"])

JavaScript


const response = await fetch("https://api.revolab.ai/v1/voices", {
  headers: { Authorization: `Bearer ${process.env.REVOLAB_API_KEY}` },
});
const { voices } = await response.json();
console.log(voices.map((v) => v.voice_id));

Response (200 OK)


{
  "voices": [
    {
      "voice_id": "aisyah",
      "display_name": "Aisyah",
      "language": "Malay",
      "gender_style": "Female",
      "type": "premade",
      "capabilities": {
        "speed": true,
        "pitch": true,
        "emotion": false,
        "inline_emotion_tags": false
      }
    },
    {
      "voice_id": "my-clone-3374b001",
      "display_name": "My Clone",
      "language": "English",
      "gender_style": "Unknown",
      "type": "cloned",
      "capabilities": {
        "speed": true,
        "pitch": true,
        "emotion": false,
        "inline_emotion_tags": false
      }
    }
  ]
}

Field	Type	Description
`voice_id`	string	The identifier to pass as `voice_id` to `POST /v1/tts`.
`display_name`	string	Human-readable voice name, as shown in the dashboard.
`language`	string	Primary language of the voice.
`gender_style`	string	Voice gender/style descriptor.
`type`	string	`"premade"` (public catalog) or `"cloned"` (your organization’s clone).
`capabilities`	object	Per-voice tuning flags: `speed`, `pitch`, `emotion`, `inline_emotion_tags`.

Only voices your key can actually use are returned — another organization’s clones never appear, and disabled voices are filtered out.

Status codes

401 Unauthorized — Missing, invalid, or revoked API key


{
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key format. Keys must start with 'rvl_live_'.",
    "request_id": "req_01HXYZ..."
  }
}

ElevenLabs shape

The same path doubles as the ElevenLabs-compatible voice list: authenticate with the xi-api-key header instead of Authorization: Bearer and the response uses the ElevenLabs voice-list schema (name, category, labels, preview_url), with category reflecting premade vs cloned. See ElevenLabs compatibility.

TTS API — synthesize with a voice_id from this list
Authentication — how to send your API key
Error catalog — full list of error codes