Skip to main content
POST
Liste as imagens geradas pela conta conectada, das mais recentes para as mais antigas. Inclui status, dimensões e expiração; use nextCursor para a próxima página.

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: images: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: 20.
string
O nextCursor da página anterior.Comprimento mínimo: 1. Comprimento máximo: 512.
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 página de metadados de imagens geradas no aplicativo do usuário conectado, dos mais recentes aos mais antigos. Um histórico vazio retorna items: [] e nextCursor: null.

Campos do resultado

Notas da operação

  • Exige images:read. limit usa 20 por padrão e deve ser um número inteiro de 1 a 100. cursor é opcional e limitado a 512 caracteres.
  • Passe nextCursor sem alterações como cursor para a próxima página. nextCursor é null no final; a ordenação usa o horário de criação e o identificador da geração em ordem decrescente.
  • Esta ação usa as criações e os envios do próprio usuário conectado, inclusive quando a credencial está conectada em um contexto de equipe.
  • Os registros expõem os status pending, completed, failed ou expired. As dimensões podem ser null para gerações não concluídas ou com falha. Os metadados podem informar expired antes que a limpeza remova um registro; isso não torna a imagem disponível para download.
  • Somente imagens geradas pelo aplicativo pertencem a este histórico. Use images_download para obter os dados da imagem; os históricos não incorporam bytes de imagens nem URLs de prévia.

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