Skip to main content
POST
Liste seu histórico de falas, das mais recentes para as mais antigas. Passe nextCursor como cursor para recuperar criações mais antigas.

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

integer
Valor inteiro.Mínimo: 1. Máximo: 100. Valor padrão: 30.
string
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. Página de resumos do histórico de fala, dos mais recentes aos mais antigos, e o cursor para solicitar criações anteriores.

Campos do resultado

Notas da operação

  • limit tem 30 como padrão e varia de 1 a 100. Passe o nextCursor retornado como cursor para a página seguinte.
  • nextCursor é null quando são retornados menos de limit itens. Uma última página cheia ainda pode retornar um cursor; a próxima chamada pode estar vazia.
  • Cada textPreview contém no máximo os primeiros 180 caracteres. Use tts_get para obter o roteiro completo e a URL do áudio.
  • Os itens de histórico informam status: success. Isso difere de status: completed em um resultado de geração de fala.
  • 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