v1

latestOpenAPI 3.0.02026-07-26152942.8 KB

voices

Get voice details by ID

Gets detailed information about a specific voice by its voice ID. Only supports preset voices.

get/v1/voices/{voice_id}

Path parameters

voice_idstring required

Response

Voice details retrieved successfully

voice_idstring required

Unique identifier for the voice

namestring required

Name of the voice

descriptionstring nullable

Description of the voice

agestring required

Age of the voice

genderstring required

Gender of the voice

use_casestring required

Use case of the voice

use_casesstring[] required

Use cases of the voice (array)

languagestring[] required

Languages supported by the voice

stylesstring[] required

Styles available for the voice

modelsstring[] required

Models available for the voice

thumbnail_image_urlstring

URL to the thumbnail image for the voice

Example response

{
  "voice_id": "<voice-id>",
  "name": "Agatha",
  "age": "young-adult",
  "gender": "female",
  "use_case": "narration",
  "use_cases": [
    "narration",
    "storytelling"
  ],
  "language": [
    "ar",
    "bg",
    "cs",
    "da",
    "de",
    "el",
    "en",
    "es",
    "et",
    "fi",
    "fr",
    "hi",
    "hu",
    "id",
    "it",
    "ja",
    "ko",
    "nl",
    "pl",
    "pt",
    "ro",
    "ru",
    "vi"
  ],
  "styles": [
    "kind-default",
    "normal",
    "serene"
  ],
  "models": [
    "sona_speech_1",
    "sona_speech_2",
    "sona_speech_2_flash",
    "supertonic_api_1",
    "supertonic_api_3"
  ],
  "samples": [
    {
      "language": "ko",
      "style": "kind-default",
      "model": "supertonic_api_3",
      "url": "https://example.com/samples/sample-audio.wav"
    }
  ],
  "thumbnail_image_url": "https://example.com/thumbnails/voice-thumbnail.png"
}