GET/api/v6/tts/voices

Listar voces disponibles

Catálogo de voces para síntesis, filtrable.

Alcance

API key con el servicio tts habilitado

Límite de uso

120 solicitudes por minuto

Devuelve el catálogo de voces para síntesis. Cada voz trae un code estable que envías en el campo voice al sintetizar. El catálogo cambia raras veces: conviene guardarlo en caché de tu lado.

Parámetros de consulta

language

stringopcional

Filtra por idioma y región (BCP-47), por ejemplo es-US o en-US.

tier

stringopcional

Filtra por nivel de calidad de la voz.

basicintermediateadvanced

gender

stringopcional

Filtra por género de la voz.

femalemale

Respuestas

200

Catálogo de voces, filtrado si enviaste parámetros.

{
  "success": true,
  "data": {
    "voices": [
      {
        "code": "es-us-female-2",
        "name": "Valentina · Español Latinoamérica",
        "language": "es-US",
        "accent": "Español Latinoamérica",
        "gender": "female",
        "tier": "intermediate",
        "sampleRate": 8000
      },
      {
        "code": "en-us-female-1",
        "name": "Emma · Inglés (EE. UU.)",
        "language": "en-US",
        "accent": "Inglés (EE. UU.)",
        "gender": "female",
        "tier": "basic",
        "sampleRate": 8000
      }
    ]
  },
  "meta": {
    "requestId": "8f0c0e2a4b1d4c8fae2b7a91e0c5d3f6",
    "timestamp": "2026-06-23T15:04:05+00:00",
    "responseTimeMs": 1.4
  }
}

401

Credenciales inválidas o faltantes.

403

La API key no tiene habilitado el servicio tts.

429

Se excedió el límite de solicitudes.

Errores posibles

Códigos que este endpoint puede devolver en error.code. El detalle completo está en el catálogo.

401AUTH_REQUIREDNo se envió un token Bearer y cada llamada lo requiere.401AUTH_INVALID_KEYLa API key no se reconoce: formato equivocado, revocada o vencida.401AUTH_SERVICE_NOT_ALLOWEDLa key no tiene permitido el servicio detrás de este endpoint.429RATE_TPS_EXCEEDEDExcediste el cupo de tu organización para este endpoint.

Ver el catálogo completo

Alcance y límites

Parámetros de consulta

Respuestas

Errores posibles