Skip to main content

Voices

List voices​

Returns the available system voices. Pass the returned voice_id when calling Generate audio.

GET /v1/voices

Query parameters​

Swipe or scroll sideways to read all columns. With the table focused, use the left and right arrow keys.

ParameterTypeDescription
languagestringFilter by language tag, for example en-US.
genderstringFilter by gender, for example female or male. Matching is case-insensitive.

Example​

curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.acoust.io/v1/voices?language=en-US&gender=female"

Response​

{
"voices": [
{
"name": "Alison",
"voice_id": "v_Z2gBESGW6p2JmXWs",
"languages": ["en-US"],
"gender": "Female"
}
]
}

name is the display label. languages lists all supported BCP-47 language codes. Filtering does not narrow the languages array. voice_id is immutable and is the recommended identifier for saved integrations. Voice IDs are case-sensitive and contain v_ followed by 16 URL-safe characters (18 characters total). Response gender casing reflects the catalog.


List cloned voices​

Returns cloned voices approved for the authenticated account. Pass the returned voice_id when calling Generate audio. Only approved voices owned by the account are listed.

GET /v1/voices/cloned

Example​

curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.acoust.io/v1/voices/cloned"

Response​

{
"voices": [
{
"name": "My Voice",
"voice_id": "v_ASNFZ4mrze8BI0Vn",
"languages": ["en-US"]
}
]
}

The cloned voice's voice_id is immutable. name is its display label, and languages lists its supported language codes.