Synthesize (GET)¶
Converte texto em fala.
Requisição
GET /rest/v2/synthesize
HTTP Headers
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
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
- 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 GET \
-H "Authorization: Bearer <token>" \
"https://tts.cpqd.com.br/rest/v2/synthesize?text=Al%C3%B4%20Mundo!" \
> 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:passwd
no comando curl para enviar as credenciais na execução do método.