Melhoria de imagens

API de melhoria de imagens

Melhoria automática, correção de perspetiva, substituição de céu e desfocagem — endpoints para limpar fotos imobiliárias.

Os endpoints de melhoria de imagens corrigem problemas comuns das fotos de anúncios: iluminação fraca, perspetiva inclinada, céus cinzentos e conteúdo sensível à privacidade. Cada um aceita um URL de imagem e devolve o resultado processado.

Melhoria automática

POST/api/enhance

Melhora automaticamente iluminação, equilíbrio de cor, nitidez e contraste. Usa-o como passo de limpeza padrão em fotos de anúncios em bruto.

Exemplos de melhoria de imagens

Fotos reais de anúncios antes e depois do passe de melhoria — divisões escuras, cor fraca, foco suave.

Ver exemplos →

Parâmetros

apiKeystringobrigatório

A tua chave API.

imageUrlstringobrigatório

URL da foto a melhorar, ou um data URI base64.

preserveOriginalFramingboolean

Mantém o aspect ratio e o enquadramento originais exatos. Define true para portais com especificações de imagem estritas.

Default: false

Pedido de exemplo

curl -X POST https://app.pedra.ai/api/enhance \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "imageUrl": "https://example.com/listing-photo.jpg",
    "preserveOriginalFraming": true
  }'

Resposta de exemplo

JSON

{
  "message": "Success",
  "output": [
    { "url": "https://pedraimages.s3.eu-west-3.amazonaws.com/<generated-id>" }
  ]
}

Tempo de resposta: ~10 segundos por imagem. A resposta pode incluir vários URLs quando o modelo produz variantes.

Melhorar + corrigir perspetiva

POST/api/enhance_and_correct_perspective

Igual a /api/enhance mas com um passo prévio de correção de perspetiva que endireita as linhas verticais. Usa-o quando as fotos do anúncio foram tiradas com o telemóvel inclinado.

Exemplos de melhoria de imagens

Mesma galeria que /api/enhance — a correção de perspetiva é mais visível em exteriores inclinados.

Ver exemplos →

Parâmetros

apiKeystringobrigatório

A tua chave API.

imageUrlstringobrigatório

URL da foto, ou um data URI base64.

preserveOriginalFramingboolean

Quando true, o pipeline preserva exatamente o enquadramento, aspect ratio e resolução da entrada (sem corte de bordas). Concebido para verticais de verificação onde a saída tem de representar legalmente a foto capturada.

Default: false

Formato de resposta: igual a /api/enhance (array). Tempo de resposta: ~15 segundos por imagem.

Substituição de céu

POST/api/sky_blue

Substitui um céu cinzento, nublado ou desbotado por um azul limpo. Afeta apenas pixels do céu — o resto da imagem fica intacto.

Exemplos de melhoria de imagens

Exteriores nublados transformados em fotos de anúncios com céu azul limpo.

Ver exemplos →

Parâmetros

apiKeystringobrigatório

A tua chave API.

imageUrlstringobrigatório

URL da foto exterior, ou um data URI base64.

Pedido de exemplo

curl -X POST https://app.pedra.ai/api/sky_blue \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "imageUrl": "https://example.com/exterior-photo.jpg"
  }'

Resposta de exemplo

JSON

{
  "message": "Success",
  "output": {
    "url": "https://pedraimages.s3.eu-west-3.amazonaws.com/<generated-id>"
  }
}

Tempo de resposta: ~10 segundos por imagem. Nota: aqui output é um objeto único, não um array.

Desfocar objetos

POST/api/blur

Desfoca automaticamente conteúdo sensível como rostos, matrículas ou logos. Útil para fotos exteriores conformes com portais.

Parâmetros

apiKeystringobrigatório

A tua chave API.

imageUrlstringobrigatório

URL da foto fonte.

objectsToBlurstringobrigatório

Lista separada por vírgulas do que desfocar. Exemplos: "faces", "license plates", "logos", "faces, license plates".

Pedido de exemplo

curl -X POST https://app.pedra.ai/api/blur \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "imageUrl": "https://example.com/photo.jpg",
    "objectsToBlur": "faces, license plates"
  }'

Resposta de exemplo

JSON

{
  "message": "Success",
  "output": {
    "url": "https://pedraimages.s3.eu-west-3.amazonaws.com/<generated-id>"
  }
}

Tempo de resposta: ~10 segundos por imagem. output é um objeto único.

Seguinte

Ver Home staging virtual para edição de mobiliário e conteúdo, ou Criar vídeo para gerar vídeos de anúncios a partir de fotos.