Imagens

Consultar imagem

Retorna o status e a URL assinada (quando DONE) de uma geração de imagem. Use em polling (recomendado: a cada 4s) até status=DONE para obter a url.

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

Autenticação

Envie sua chave de API no cabeçalho Authorization.

Cabeçalho

Authorization: Bearer <SEU_TOKEN_DE_API>

Parâmetros

Caminho (URL)

idintegerobrigatório
ID numérico da geração, retornado pelo POST /api/v1/images.
Exemplo: 4821

Respostas

200 OKDados da geração. Campo url preenchido apenas quando status=DONE.

Resposta

{
  "success": true,
  "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"
}

Observações

status pode ser: PENDING | PROCESSING | GENERATING | DONE | ERROR.
url é null enquanto status != DONE. Só faça fetch da imagem quando status=DONE.
A URL assinada tem validade de 7 dias.