Listar voces

Devuelve las voces disponibles para tu empresa. Usa el voiceId de cualquier voz de esta lista como voiceId al crear o editar un agente.

La lista incluye el catálogo de voces de Fonema más las voces personalizadas agregadas a tu empresa.

Autenticación

AuthorizationBearer

Autentica las solicitudes desde tu servidor con una API Key de Fonema. Créala en la sección de API Keys del Dashboard y envíala en el encabezado Authorization como Bearer <token>. No pongas tus claves en código del navegador ni en repositorios públicos.

Respuesta

voicesarray

Voces disponibles para tu empresa.

voices[].voiceIdstring

Identificador de la voz. Envíalo como voiceId al crear o editar un agente.

voices[].namestring

Nombre de la voz.

voices[].countrystring

País / acento de la voz.

voices[].audiostring

URL de una muestra de audio para escuchar la voz.

voices[].languagestring

Idioma de la voz.

voices[].sexstring

Género de la voz. Las voces personalizadas de tu empresa devuelven Custom.

voices[].detailstring

Descripción breve del estilo de la voz. En voces personalizadas, el proveedor de la voz.

GET/v1/voices

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

200OK

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