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.
| Parameter | Type | Description |
|---|---|---|
language | string | Filter by language tag, for example en-US. |
gender | string | Filter 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.