Pular para o conteúdo principal
POST
Gerar fala

Escolher uma voz

Defina voice no nível superior para solicitações portáveis. O Phaseo associa esse valor à voz do provedor roteado; uma voice que o provedor e o modelo roteados não aceitam retorna 400 invalid_request_error com param: "voice". Para eleven-labs/eleven-v4 e eleven-labs/eleven-v4-turbo, passe qualquer ID de 20 caracteres da biblioteca de vozes da ElevenLabs, inclusive um clone personalizado. Defina config.elevenlabs.voice_settings.stability e similarity_boost conforme necessário. O Eleven v4 não aceita speed nem voice_settings.style.

Passar uma voz nativa do provedor

Para usar a configuração de voz do próprio provedor em vez de voice:
  • ElevenLabs: config.elevenlabs.voice_id, config.elevenlabs.voice ou config.elevenlabs.voiceName.
  • Google: config.google.voice_name ou config.google.voiceName.

Autorizações

Authorization
string
header
obrigatório

Autenticação com token Bearer

Corpo

application/json
model
string
obrigatório
input
string
obrigatório
models
string[]

Modelos de fallback opcionais e ordenados, tentados depois de model. model é obrigatório e é sempre o modelo principal. Quando uma tentativa falha com 429, 500, 502, 503 ou 504, a próxima entrada é tentada; os demais erros são retornados sem alteração. Aceita até 25 IDs de modelo ou predefinições; duplicatas e entradas iguais a model são ignoradas. Cada tentativa é validada, registrada e cobrada como uma solicitação separada, e o campo model da resposta e o rastreamento de roteamento mostram o modelo que atendeu a solicitação. Solicitações em streaming só recorrem a um fallback antes do primeiro byte, e trabalhos de vídeo e música apenas no envio. Solicitações de batch, realtime e council rejeitam models. Fallbacks definidos em uma rota dinâmica têm precedência, e phaseo/auto não pode ser combinado com models.

Required array length: 1 - 25 elements
Minimum string length: 1
Exemplo:
voice
string
speed
number
Intervalo obrigatório: 0.25 <= x <= 4
format
enum<string>
Opções disponíveis:
mp3,
wav,
ogg,
aac
provider
object

Preferências de roteamento de provedores para seleção pelo gateway.

config
object

Resposta

200 - audio/mpeg

Arquivo de áudio

The response is of type file.

Última modificação em 16 de novembro de 2026