Saltar al contenido principal
POST
Generar voz

Elige una voz

Configura voice en el nivel superior para que las solicitudes sean portables. Phaseo lo asigna a la voz del proveedor enrutado; un voice que el proveedor y el modelo enrutados no aceptan devuelve 400 invalid_request_error con param: "voice". Para eleven-labs/eleven-v4 y eleven-labs/eleven-v4-turbo, pasa cualquier ID de 20 caracteres de la biblioteca de voces de ElevenLabs, incluido un clon personalizado. Configura config.elevenlabs.voice_settings.stability y similarity_boost según lo necesites. Eleven v4 no admite speed ni voice_settings.style.

Pasa una voz nativa del proveedor

Para usar el ajuste de voz propio de un proveedor en lugar de voice:
  • ElevenLabs: config.elevenlabs.voice_id, config.elevenlabs.voice o config.elevenlabs.voiceName.
  • Google: config.google.voice_name o config.google.voiceName.

Autorizaciones

Authorization
string
header
requerido

Autenticación con token Bearer

Cuerpo

application/json
model
string
requerido
input
string
requerido
models
string[]

Modelos de respaldo opcionales y ordenados que se prueban después de model. model es obligatorio y siempre es el modelo principal. Cuando un intento falla con 429, 500, 502, 503 o 504, se prueba la siguiente entrada; los demás errores se devuelven sin cambios. Acepta hasta 25 IDs de modelo o presets; se ignoran los duplicados y las entradas iguales a model. Cada intento se valida, registra y factura como una solicitud independiente, y el campo model de la respuesta y la traza de enrutamiento muestran el modelo que atendió la solicitud. Las solicitudes en streaming solo recurren a un respaldo antes del primer byte, y los trabajos de video y música solo al enviarse. Las solicitudes de batch, realtime y council rechazan models. Los respaldos definidos en una ruta dinámica tienen prioridad, y phaseo/auto no se puede combinar con models.

Required array length: 1 - 25 elements
Minimum string length: 1
Ejemplo:
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 16 de noviembre de 2026