Voices

Obtém a relação das vozes disponíveis.

Requisição

GET /rest/v2/voices

HTTP Headers

Authorization

(opcional) Token de acesso em formato Bearer.

Parâmetros da requisição

Nenhum.

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.

500

erro interno no servidor que impediu o processamento da requisição.

Resultado

O resultado é um objeto que possui a seguinte estrutura:

  • name: nome da voz.

  • languages: lista de idiomas suportados pela voz.

  • mode: indica o modo de operação da voz: PERFORMANCE ou QUALITY. Vozes no modo PERFORMANCE priorizam desempenho, entregando sínteses mais rápidas, enquanto que vozes QUALITY priorizam a qualidade do áudio resultante.

  • available: indica se a voz está disponível para uso utilizando o token atual.

Exemplos

Chamada REST:

curl -X GET \
 -H "Authorization: Bearer <token>" \
 --header "Accept: application/json" \
 "https://tts.cpqd.com.br/rest/v2/voices"

Resultado JSON:

[
  {
    "name": "adriana-neutro-performance",
    "languages": ["pt-br"],
    "mode": "PERFORMANCE",
    "available": false
  }
]

Resultado de erro JSON:

[
  {
    "code": "500",
    "message": "only the get method is accepted"
  }
]

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.