Imagens

Upload de imagem de referência

Faz upload de uma imagem de referência para ser usada na geração. Retorna a 'key' que deve ser passada como referencePath no POST /api/v1/images. Requer plano pago ou ADMIN (plano 8 retorna 403).

POSThttps://darkvi.com/api/v1/images/reference

Autenticação

Envie sua chave de API no cabeçalho Authorization. Token gerado em darkvi.com/settings. Requer plano pago ou ADMIN.

Cabeçalho

Authorization: Bearer <SEU_TOKEN_DE_API>

Parâmetros

Corpo (JSON)

filefileobrigatório
Arquivo de imagem a usar como referência. Formatos aceitos: PNG, JPEG, WebP. Tamanho máximo: 10 MB. A imagem é convertida para WebP (máx 1536×1536) antes do armazenamento.
Exemplo: (binário da imagem)

Exemplo de requisição

JSON

(multipart/form-data com campo 'file')

Respostas

200 OKUpload concluído. Use o campo 'key' como referencePath no POST /api/v1/images.

Resposta

{
  "success": true,
  "key": "reference_image/550e8400-e29b-41d4-a716-446655440000.webp",
  "url": "https://r2.example.com/reference_image/550e8400-e29b-41d4-a716-446655440000.webp"
}

Observações

Envie a requisição como multipart/form-data com o campo 'file' contendo o arquivo de imagem.
A imagem é redimensionada para no máximo 1536×1536 px e convertida para WebP antes do armazenamento.
A 'key' retornada deve ser passada como referencePath no POST /api/v1/images para usar a referência na geração.
Disponível apenas para planos pagos e ADMIN. Plano 8 (gratuito) recebe 403.
Burst limit: 10 uploads/minuto (ADMINs: 40/minuto).