Skip to main content
POST
Liste as vozes de fala disponíveis, suas vozes personalizadas salvas, prévias reproduzíveis ainda válidas e suas cotas de criação de vozes.

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

Envie um objeto JSON vazio. Esta ação não possui campos de entrada.
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. Vozes disponíveis do catálogo TTS e vozes personalizadas salvas pertencentes à conta, cota de vagas salvas, prévias ativas não salvas e cotas de criação de voz.

Campos do resultado

Notas da operação

  • O catálogo do exemplo está abreviado. A ação retorna a biblioteca TTS disponível, com as vozes personalizadas salvas antes das entradas do catálogo.
  • Use voices[].id em tts_generate. As vozes salvas usam clone:<UUID>; os IDs do catálogo são opacos. Esses IDs são separados de dubbing_voices_list.
  • As entradas do catálogo incluem accent, gender, style e previewFileName; previewUrl é opcional. As entradas personalizadas salvas incluem accent: original, source: clone e um previewUrl temporário.
  • canClone indica se o plano permite vozes TTS personalizadas salvas; remaining indica vagas livres. Criações reservadas podem contar em used.
  • voicePreviews inclui apenas candidatos pertencentes ao usuário, não salvos, prontos e não expirados. Uma prévia dura 24 horas; sua URL reproduzível pode expirar antes.
  • cloneTrial é uma cota vitalícia de uma prévia de clonagem. Os planos pagos têm cinco requisições de criação por dia UTC; cada criação bem-sucedida gera dois candidatos. creationUsage informa a cota atual e o horário de renovação.
  • 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