Skip to main content
GET
Get voice details by ID
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

Path parameters

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:
language
string[]
required

Languages supported by the voice

Example:
styles
string[]
required

Styles available for the voice

Example:
models
string[]
required

Models available for the voice

Example:
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"