List voices

Returns the voices available to your company. Use the voiceId of any voice in this list as the voiceId when you create or edit an agent.

The list includes Fonema's voice catalog plus any custom voices added to your company.

Authentication

AuthorizationBearer

Authenticate server-side requests with a Fonema API key. Create one in the API keys section of the Dashboard and send it in the Authorization header as Bearer <token>. Keep keys out of client-side code and public repositories.

Response

voicesarray

Voices available to your company.

voices[].voiceIdstring

Voice identifier. Send it as voiceId when creating or editing an agent.

voices[].namestring

Display name of the voice.

voices[].countrystring

Country / accent of the voice.

voices[].audiostring

URL of an audio sample to preview the voice.

voices[].languagestring

Voice language.

voices[].sexstring

Voice gender. Custom voices added to your company return Custom.

voices[].detailstring

Short description of the voice style. For custom voices, the voice provider.

GET/v1/voices

$curl -X GET "https://api.fonema.ai/v1/voices" \
>     -H "Authorization: Bearer YOUR_API_KEY"

200OK

1{
2  "voices": [
3    {
4      "voiceId": "YOUR_VOICE_ID",
5      "name": "Sofia",
6      "country": "Mexico",
7      "audio": "https://.../sofia_mexico_spanish_female_warm_YOUR_VOICE_ID.mp3?v=2",
8      "language": "Spanish",
9      "sex": "Female",
10      "detail": "warm"
11    }
12  ]
13}