Voices

Voice endpoints expose existing Braiv voice clones. In the beta, API-based voice cloning is not available yet.

List voices

GET https://api.braiv.com/v1/voices
xi-api-key: YOUR_BRAIV_API_KEY

Response

{
  "voices": [
    {
      "voice_id": "YOUR_VOICE_ID",
      "name": "Narrator",
      "category": "generated",
      "description": "Warm narration voice",
      "labels": {
        "language": "en",
        "gender": "female",
        "age": "young adult"
      },
      "preview_url": "https://...",
      "available_for_tiers": ["pro", "business"],
      "settings": {
        "stability": null,
        "similarity_boost": null,
        "style": null,
        "use_speaker_boost": null,
        "speed": 1
      }
    }
  ]
}

Get a voice

GET https://api.braiv.com/v1/voices/{voice_id}
xi-api-key: YOUR_BRAIV_API_KEY

Returns the same voice object shape as GET /v1/voices.

Ownership

Only voice clones owned by the API key’s user are returned. Requests for missing or non-owned voices return 404.