Ctrl K

API Reference

Get available voices

Retrieve all available voices for assistant configuration

Updated 30 June 2026

On this page

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

modestring

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

language_idinteger

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

synthesizer_provider_idinteger

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

genderstring

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

agestring

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

accentstring

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

searchstring

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

Response fields

dataarray

idinteger

  The unique identifier of the voice

namestring

  The display name of the voice

language_idinteger

  The language ID this voice is associated with

genderstring

  The gender of the voice (male/female)

preview_urlstring

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

accentstring

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

agestring

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

synthesizer_provider_idinteger

  The TTS provider ID this voice belongs to. Use the [Get Synthesizer Providers](/api-reference/assistants/get-synthesizer-providers) endpoint to resolve provider names. May be `null`.

[
  {
    "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

Related guides

API Reference

Introduction

Welcome to the VoxLink API

Read guide →

API Reference

Authentication

Learn how to authenticate your API requests

Read guide →

API Reference

Get current user

Get the authenticated user's profile information

Read guide →

API Reference

List assistants

List all assistants for the authenticated user with pagination

Read guide →