Imagens

Listar imagens

Retorna a lista paginada de gerações de imagem do usuário autenticado, da mais recente para a mais antiga.

GEThttps://darkvi.com/api/v1/images

Autenticação

Envie sua chave de API no cabeçalho Authorization.

Cabeçalho

Authorization: Bearer <SEU_TOKEN_DE_API>

Parâmetros

Query string

pageintegeropcional
Página da listagem. Padrão: 1.
Exemplo: 1
limitintegeropcional
Itens por página. Padrão: 10. Máximo: 50.
Exemplo: 10

Respostas

200 OKLista paginada de gerações. Campo url preenchido apenas em itens com status=DONE.

Resposta

{
  "success": true,
  "data": [
    {
      "id": 4821,
      "prompt": "Um dragão voando sobre montanhas nevadas ao pôr do sol, estilo fotorrealista",
      "status": "DONE",
      "aspect": "16:9",
      "url": "https://r2.example.com/signed-url...",
      "createdAt": "2026-06-06 14:00:00.000000",
      "updatedAt": "2026-06-06 14:01:23.000000"
    },
    {
      "id": 4820,
      "prompt": "Floresta tropical ao amanhecer",
      "status": "PENDING",
      "aspect": null,
      "url": null,
      "createdAt": "2026-06-06 13:55:00.000000",
      "updatedAt": "2026-06-06 13:55:00.000000"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 42,
    "totalPages": 5
  }
}

Observações

Itens com disable=1 (soft-deleted) são excluídos automaticamente.
url é null para imagens ainda em processamento (PENDING/PROCESSING/GENERATING) ou com ERROR.
A URL assinada tem validade de 7 dias.