Skip to main content
GET
/
v1
/
voices
/
{voice_id}
Get voice details by ID
curl --request GET \
  --url https://supertoneapi.com/v1/voices/{voice_id} \
  --header 'x-sup-api-key: <api-key>'
{
  "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"
  ],
  "description": "",
  "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"
}

Documentation Index

Fetch the complete documentation index at: https://docs.supertoneapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Returns the full voice object for a single preset voice — including supported languages, styles, models, and pre-rendered sample URLs. For customer-cloned voices, use Get custom voice instead.

​
Endpoint

GET https://supertoneapi.com/v1/voices/{voice_id}

​
Path parameters

NameRequiredDescription
voice_id✅The ID of the preset voice.

​
Response

Returns the voice object — see Voices for the field-by-field reference.

​
Notes

  • Returns 404 Not Found if the voice_id doesn’t exist on your account.
  • Use this endpoint to look up the default style for a voice (the first entry in styles) before calling TTS without an explicit style parameter.

​
See also

Docs: Voices

Voice object shape and how to use voice IDs.

List voices

Browse the full voice library.

Authorizations

​
x-sup-api-key
string
header
required

Path Parameters

​
voice_id
string
required

Response

Voice details retrieved successfully

​
voice_id
string
required

Unique identifier for the voice

Example:

"<voice-id>"

​
name
string
required

Name of the voice

Example:

"Agatha"

​
age
string
required

Age of the voice

Example:

"young-adult"

​
gender
string
required

Gender of the voice

Example:

"female"

​
use_case
string
required

Use case of the voice

Example:

"narration"

​
use_cases
string[]
required

Use cases of the voice (array)

Example:
["narration", "storytelling"]
​
language
string[]
required

Languages supported by the voice

Example:
[
  "ar",
  "bg",
  "cs",
  "da",
  "de",
  "el",
  "en",
  "es",
  "et",
  "fi",
  "fr",
  "hi",
  "hu",
  "id",
  "it",
  "ja",
  "ko",
  "nl",
  "pl",
  "pt",
  "ro",
  "ru",
  "vi"
]
​
styles
string[]
required

Styles available for the voice

Example:
["kind-default", "normal", "serene"]
​
models
string[]
required

Models available for the voice

Example:
[
  "sona_speech_1",
  "sona_speech_2",
  "sona_speech_2_flash",
  "supertonic_api_1",
  "supertonic_api_3"
]
​
description
string | null

Description of the voice

Example:

""

​
samples
object[]

URL to the sample audio file for the voice

​
thumbnail_image_url
string

URL to the thumbnail image for the voice

Example:

"https://example.com/thumbnails/voice-thumbnail.png"