Synthesize¶
Converte texto em fala.
Requisição
POST /rest/v2/synthesize
HTTP Headers
Content-Length |
Indica o número de bytes do conteúdo. |
Content-Type |
|
X-Account-Tag |
(opcional) Indica o utilizador. Esse campo pode ser utilizado para discriminar o consumo de uma equipe, cenário de uso ou subcliente. |
Authorization |
Token de acesso em formato Bearer. |
- Parâmetros da requisição
O corpo da requisição deve ser um objeto JSON com os seguintes atributos.
text
o texto a ser convertido em áudio, codificado como URL
voice
(opcional) o nome da voz. Veja valores válidos em Voices
encoder
(opcional) o nome do encoder de áudio. Veja valores válidos em Encoders
rate
(opcional) define o ritmo padrão. Valores aceitos: 0.3 (lento) a 3.0 (rápido). O valor padrão é 1.0.
filename
(opcional) o nome do arquivo de áudio no download
use_streaming
(opcional) Ativa o uso de síntese via streaming. O valor padrão é
false.- Erros
O corpo do erro é um objeto JSON com os seguintes atributos.
code
código do erro.
message
mensagem descritiva do erro ocorrido.
Os seguintes códigos de erro podem ser retornados.
400
parâmetro de entrada inválido.
401
usuário não autenticado.
403
usuário não está autorizado para usar este endpoint.
500
erro interno no servidor que impediu o processamento da requisição.
- Resultado
Stream de bytes de áudio.
Exemplos
Chamada REST:
curl -X POST \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
"https://tts.cpqd.com.br/rest/v2/synthesize" \
--data "{ \"text\": \"Alô mundo\", \"voice\": \"adriana_natural\" }" \
> audio.wav
Nota
Para testar esse serviço no ambiente de demonstração do CPQD, utilize a URL https://tts.cpqd.com.br seguido do método da API REST.
O acesso ao ambiente de demonstração exige uso de uma credencial de acesso fornecida pelo CPQD. Utilize o parâmetro
--user username:passwdno comando curl para enviar as credenciais na execução do método.