Get available voices

Retrieve all available voices for assistant configuration

GET /user/assistants/voices

Get available voices

cURL

curl --request GET \
  --url https://app.autocalls.ai/api/user/assistants/voices \
  --header 'Authorization: Bearer <token>'

200 Response

[
  {
    "id": 1,
    "name": "Alloy",
    "language_id": 1,
    "gender": "female",
    "preview_url": "https://cdn.openai.com/API/voice-previews/alloy.flac",
    "accent": null,
    "age": "Middle aged",
    "synthesizer_provider_id": null
  },
  {
    "id": 10,
    "name": "Zephyr",
    "language_id": 1,
    "gender": "female",
    "preview_url": "https://gstatic.com/aistudio/voices/samples/Zephyr.wav",
    "accent": null,
    "age": "Middle aged",
    "synthesizer_provider_id": 1
  },
  {
    "id": 11,
    "name": "Puck",
    "language_id": 1,
    "gender": "male",
    "preview_url": "https://gstatic.com/aistudio/voices/samples/Puck.wav",
    "accent": null,
    "age": "Middle aged",
    "synthesizer_provider_id": 1
  }
]

This endpoint returns a list of all available voices that can be used when creating or updating assistants, with optional filtering by assistant mode and language.

Query Parameters

mode · string

Filter voices by assistant mode. Options: pipeline, multimodal, dualplex

language_id · integer

Filter voices by language ID. Use the Get Languages endpoint to get available language IDs.

synthesizer_provider_id · integer

Filter voices by TTS provider ID (e.g. ElevenLabs, Cartesia, Azure). Use the Get Synthesizer Providers endpoint to get available provider IDs.

gender · string

Filter voices by gender (e.g., male, female).

age · string

Filter voices by age category (e.g., Young, Middle aged).

accent · string

Filter voices by accent (e.g., American, British).

search · string

Free-text search across voice name, accent, age, and gender.

Response fields

data · array

Show properties

id · integer

The unique identifier of the voice

name · string

The display name of the voice

language_id · integer

The language ID this voice is associated with

gender · string

The gender of the voice (male/female)

preview_url · string

URL to an audio sample of the voice. Can be used to let users preview voices before selecting one.

accent · string

The accent of the voice (e.g., “American”, “British”). May be null.

age · string

The age category of the voice (e.g., “Young”, “Middle aged”). May be null.

synthesizer_provider_id · integer

The TTS provider ID this voice belongs to. Use the Get Synthesizer Providers endpoint to resolve provider names. May be null.

200 Response

[
  {
    "id": 1,
    "name": "Alloy",
    "language_id": 1,
    "gender": "female",
    "preview_url": "https://cdn.openai.com/API/voice-previews/alloy.flac",
    "accent": null,
    "age": "Middle aged",
    "synthesizer_provider_id": null
  },
  {
    "id": 10,
    "name": "Zephyr",
    "language_id": 1,
    "gender": "female",
    "preview_url": "https://gstatic.com/aistudio/voices/samples/Zephyr.wav",
    "accent": null,
    "age": "Middle aged",
    "synthesizer_provider_id": 1
  },
  {
    "id": 11,
    "name": "Puck",
    "language_id": 1,
    "gender": "male",
    "preview_url": "https://gstatic.com/aistudio/voices/samples/Puck.wav",
    "accent": null,
    "age": "Middle aged",
    "synthesizer_provider_id": 1
  }
]

Notes

• Use the id field as voice_id when creating or updating assistants
• Filter by mode to get only voices compatible with your intended assistant type
• Filter by language_id to get voices for a specific language
• Filter by gender, age, or accent to narrow the list, or use search for free-text matching across those fields
• If no filters are provided, all available voices are returned
• Only voices that are public or belong to the authenticated user are returned