Skip to main content
POST
Consulte os metadados e um exemplo reproduzível de uma voz de dublagem do catálogo ou de uma voz personalizada que lhe pertence.

Autenticação e permissões

string
obrigatório
Envie uma chave de API VoiceCheap neste cabeçalho. Authorization: Bearer com a mesma chave de API também é aceito. Tokens de acesso OAuth são aceitos apenas pelo MCP, não por este endpoint REST.
Permissões necessárias: voices:read. É necessária uma assinatura paga ativa. As permissões não alteram funções na equipe, propriedade dos recursos, créditos de mídia ou limites do plano.

Parâmetros

string
obrigatório
Valor de texto.Comprimento mínimo: 1. Comprimento máximo: 255. Padrão: ^[A-Za-z0-9_-]+$.
string
Valor de texto.Valores aceitos: “en”, “fr”, “es”, “de”, “it”, “pt”, “pl”, “zh”, “ja”. Valor padrão: “en”.
O JSON Schema abaixo preserva os nomes exatos dos campos, tipos aninhados, valores padrão, limites e valores aceitos expostos pela descoberta. Regras adicionais entre campos são listadas nas notas da operação.

Exemplos de requisição

Substitua os identificadores de recursos e as chaves de mídia dos exemplos pelos valores retornados para sua conta. Mantenha o identificador da requisição ao tentar novamente a mesma alteração.

Resposta

Uma primeira execução bem-sucedida retorna HTTP 200 com o resultado da operação em data. Uma repetição pode retornar o estado salvo da requisição. O exemplo mostra uma resposta aceita, não todos os campos opcionais. Uma voz de dublagem do catálogo ou personalizada pertencente à conta, com seus metadados públicos e exemplo reproduzível opcional.

Campos do resultado

Notas da operação

  • Use voiceId de dubbing_voices_list. É um ID opaco de 1–255 caracteres que contém apenas letras, dígitos, sublinhados e hifens.
  • locale tem os mesmos padrões e valores aceitos de dubbing_voices_list. As vozes do catálogo podem incluir metadados localizados de language, accent, description, age, gender, useCase e category.
  • As vozes personalizadas pertencentes ao usuário retornam source: custom e previewUrl opcional; elas omitem os campos de idioma do catálogo. audioExampleUrl de uma resposta bruta de clonagem é representado aqui como previewUrl.
  • O histórico de fala e as vozes personalizadas pertencem à conta autenticada. O faturamento da equipe não concede acesso à fala nem às vozes de outro membro.

Uso

Cada chamada bem-sucedida consome uma chamada mensal da API/MCP. Os créditos de mídia e as cotas de geração da própria operação também se aplicam.

Erros