Skip to main content
GET
/
user
/
assistants
/
voices
Get available voices
curl --request GET \
  --url https://api.example.com/user/assistants/voices
[
  {
    "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
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.lacy.ai/llms.txt

Use this file to discover all available pages before exploring further.

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.

​
Response fields

​
data
array
[
  {
    "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
  • If no filters are provided, all available voices are returned
  • Only voices that are public or belong to the authenticated user are returned