Skip to main content
POST
Generar voz

Asignación de voces

voice se normaliza según el proveedor mediante un mapa interno de alias:
  • openai: voces habituales (por ejemplo alloy, ash, ballad, coral, echo, fable, onyx, nova, sage, shimmer, verse, cedar, marin).
  • google (AI Studio / Gemini TTS): voces predefinidas canónicas: Zephyr, Puck, Charon, Kore, Fenrir, Leda, Orus, Aoede, Callirrhoe, Autonoe, Enceladus, Iapetus, Umbriel, Algieba, Despina, Erinome, Algenib, Rasalgethi, Laomedeia, Achernar, Alnilam, Schedar, Gacrux, Pulcherrima, Achird, Zubenelgenubi, Vindemiatrix, Sadachbia, Sadaltager, Sulafat.
  • elevenlabs: se asignan voces públicas de uso frecuente (por ejemplo rachel, domi, bella, antoni, elli, josh, arnold, adam, sam).
Para eleven-labs/eleven-v4 y eleven-labs/eleven-v4-turbo, pasa cualquier identificador de 20 caracteres de la biblioteca de voces de ElevenLabs, incluidos los clones personalizados. Ajusta config.elevenlabs.voice_settings.stability y similarity_boost según necesites. Eleven v4 no admite speed ni voice_settings.style. Si voice no es válido para la combinación de proveedor y modelo de la ruta, la solicitud devuelve 400 invalid_request_error con param: "voice".

Anulaciones del proveedor

También puedes enviar ajustes de voz propios del proveedor:
  • ElevenLabs: config.elevenlabs.voice_id / config.elevenlabs.voice / config.elevenlabs.voiceName
  • Google: config.google.voice_name / config.google.voiceName
Usa voice en el nivel superior como valor predeterminado para facilitar la portabilidad.

Muestras de voz

Autorizaciones

Authorization
string
header
requerido

Autenticación con token Bearer

Cuerpo

application/json
model
string
requerido
input
string
requerido
voice
string
speed
number
Rango requerido: 0.25 <= x <= 4
format
enum<string>
Opciones disponibles:
mp3,
wav,
ogg,
aac
provider
object

Preferencias de enrutamiento de proveedores para la selección de la pasarela.

config
object

Respuesta

200 - audio/mpeg

Archivo de audio

The response is of type file.

Última modificación el 2 de octubre de 2026