Skip to main content
POST
Obtenha uma URL temporária reproduzível para sua prévia de voz clonada ou criada por descrição ainda não salva. Use voices_save_preview para mantê-la antes que expire.

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.Formato: “uuid”. Padrão: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$.
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 prévia de voz ativa pertencente à conta, com uma URL temporária de reprodução renovada e sua expiração.

Campos do resultado

Notas da operação

  • previewId é o UUID do candidato retornado em voicePreviews por voices_preview_clone, voices_design ou voices_list.
  • Somente prévias com status ready, não salvas e não expiradas são visíveis. Um candidato salvo passa para voices_list como clone:<previewId>. Candidatos expirados, salvos, ausentes ou pertencentes a outro usuário retornam VOICE_PREVIEW_NOT_FOUND aqui.
  • A URL é temporária e pode expirar antes de expiresAt. Salve o candidato escolhido com voices_save_preview antes que a própria prévia expire.
  • 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