Ir al contenido principal
Español— Elegir un idioma
Menú

Parámetros de la solicitud TTS

Lección 2 de 14 Actualizado el 3 de noviembre de 2026 Desarrollador
En esta página
  1. Ajusta tu síntesis de voz
  2. El parámetro text
  3. El parámetro voice_id
  4. El parámetro language
  5. El parámetro output_format
  6. El parámetro speed
  7. Combinaciones recomendadas
  8. Puntos clave

Actualizado el 3 de noviembre de 2026, basado en la página Text to Speech de xAI y la referencia de la API de Voz. Fuentes: Text to Speech · Voice API.

Ajusta tu síntesis de voz

El punto de conexión POST /v1/tts gira en torno a cuatro parámetros principales en el cuerpo de la solicitud JSON, además de algunas configuraciones opcionales. Cada uno te ofrece un control preciso sobre el audio generado y, al comprenderlos, podrás adaptar la síntesis a tu caso de uso.

El parámetro text

Junto con language, text es el único parámetro obligatorio. Acepta una cadena de hasta 60.000 caracteres, que puede contener texto plano o etiquetas expresivas (tratadas en la siguiente sección).

{
  "text": "Hello and welcome. Today, we're going to talk about artificial intelligence."
}

Si superas los 60.000 caracteres, la solicitud HTTP será rechazada. Para textos más largos, xAI recomienda usar WebSocket, que no tiene límite de longitud total (lecciones 9 a 12), o dividir el texto en segmentos cuyo audio concatenarás posteriormente. Realiza la división en límites naturales (finales de frase, finales de párrafo) para obtener un resultado fluido.

El parámetro voice_id

Este parámetro establece la voz utilizada para la síntesis. Es opcional y su valor predeterminado es eve. Los identificadores no distinguen entre mayúsculas y minúsculas: Eve, EVE y eve son equivalentes.

xAI ofrece 28 voces integradas (a fecha de 3 de noviembre de 2026), las mismas que para el agente de voz, además de voces personalizadas creadas con la API de Custom Voices. Las cinco voces originales, tal como las describe xAI:

  • eve: enérgica y alegre, acento británico
  • ara: cálida y amigable
  • rex: segura y clara
  • sal: suave y equilibrada
  • leo: autoritaria y potente, acento británico

Las otras 23 (carina, zagan, helix, orion, luna, iris, altair, zenith, perseus, helios, lux, kepler, rigel, cosmo, celeste, ursa, sirius, lumen, castor, naksh, atlas, aurora y liora) están descritas, junto con sus casos de uso, en la página Text to Speech de xAI; GET /v1/tts/voices devuelve la lista actual (lección 3).

{
  "text": "Welcome to this tutorial.",
  "voice_id": "rex",
  "language": "en"
}

Según xAI, todas las voces hablan todos los idiomas admitidos. La elección de la voz no afecta al precio, que se basa en el número de caracteres.

El parámetro language

Este parámetro es obligatorio. Acepta un código BCP-47 o el valor especial auto para la detección automática del idioma.

Los 20 idiomas admitidos son:

CodeLanguageCodeLanguage
enEnglishkoKorean
frFrenchhiHindi
deGermanbnBengali
es-ESSpanish (Spain)ar-EGArabic (Egypt)
es-MXSpanish (Mexico)ar-SAArabic (Saudi Arabia)
pt-BRPortuguese (Brazil)ar-AEArabic (UAE)
pt-PTPortuguese (Portugal)trTurkish
itItalianidIndonesian
ruRussianviVietnamese
zhChinesejaJapanese

La detección automática (auto) funciona bien para textos en un solo idioma, pero para textos que mezclan varios idiomas, indica explícitamente el idioma principal.

El parámetro output_format

Este parámetro opcional es un objeto JSON que controla el formato de salida del audio. Tiene tres subparámetros.

codec

El codec establece el formato de codificación:

  • mp3 (predeterminado): un formato comprimido, ideal para la web y la transmisión en streaming
  • wav: un formato sin pérdidas, de mayor calidad pero con archivos más grandes
  • pcm: audio crudo sin cabecera, para tuberías de procesamiento
  • mulaw / ulaw: el codec G.711 mu-law para telefonía
  • alaw: el codec G.711 A-law para telefonía

sample_rate

La frecuencia de muestreo en hercios. Valores aceptados: 8000, 16000, 22050, 24000 (predeterminado), 44100, 48000.

bit_rate

La tasa de bits en bits por segundo, solo para el codec MP3. Valores aceptados: 32000, 64000, 96000, 128000 (predeterminado), 192000.

{
  "text": "High-quality audio for production.",
  "voice_id": "ara",
  "language": "en",
  "output_format": {
    "codec": "wav",
    "sample_rate": 48000
  }
}

El parámetro speed

speed establece la velocidad de reproducción: 1.0 es la velocidad normal (el valor predeterminado), y el rango va de 0.7 a 1.5. Un ritmo ligeramente más lento ayuda con contenido educativo denso; por encima de 1.2, escucha siempre el resultado de nuevo.

Combinaciones recomendadas

Use casecodecsample_ratebit_rate
Web / streamingmp324000128000
Audio productionwav48000—
VoIP telephonymulaw8000—
ML pipelinepcm16000—

Puntos clave

  • text y language son los únicos parámetros obligatorios
  • voice_id es opcional (predeterminado: eve) y no distingue entre mayúsculas y minúsculas
  • output_format controla el codec, la frecuencia de muestreo y la tasa de bits; speed establece la velocidad (de 0,7 a 1,5)
  • MP3 a 24 kHz / 128 kbps es un buen equilibrio predeterminado entre calidad y tamaño
  • Para telefonía, usa mulaw o alaw a 8 kHz