Skip to main content
POST
Consulte uma criação de fala que lhe pertence, incluindo seu roteiro, configurações de interpretação, URL temporária de áudio e alinhamento de palavras disponível.

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: tts: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
ID do histórico retornado por tts_generate ou tts_list.Padrão: ^(free-)?[0-9a-f]{64}$.
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. Detalhes do histórico de fala pertencente à conta, roteiros completos editável e falado, configurações de interpretação, URL temporária de reprodução e quaisquer timestamps de palavras disponíveis.

Campos do resultado

Notas da operação

  • historyId deve ter 64 caracteres hexadecimais minúsculos, opcionalmente com o prefixo free-. Use o identificador retornado por tts_generate ou tts_list.
  • Propriedades opcionais de registros antigos, como voiceName, voiceSource e sourceFileName, podem ser omitidas. instructions ausente tem uma string vazia como padrão, speed ausente tem 1 e previewEndIndex ausente tem null.
  • wordAlignment pode ser null. Esta leitura carrega o alinhamento existente; use tts_align para preparar timestamps.
  • Os índices de caracteres de origem em wordAlignment se referem a spokenText, que tem as tags de controle de interpretação removidas.
  • audioUrl é temporária. Chame tts_get novamente para renovar a reprodução ou tts_download para obter um link de download.
  • 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