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
propertyIdstring
Id opcional da propriedade (de list_properties ou create_property) a que esta foto pertence. Quando definido, o resultado é guardado na galeria dessa propriedade — visível e editável a partir da app — em vez de ser apenas devolvido como URL.

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://img.pedra.ai/<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
propertyIdstring
Id opcional da propriedade (de list_properties ou create_property) a que esta foto pertence. Quando definido, o resultado é guardado na galeria dessa propriedade — visível e editável a partir da app — em vez de ser apenas devolvido como URL.

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 e melhora a iluminação. Por defeito um céu azul limpo; usa skyStyle para escolher outra hora do dia (amanhecer, pôr do sol, noite).

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.
skyStylestring
Qual céu e iluminação aplicar. Por defeito "sunny". Opções: "sunny" (céu azul limpo e brilhante), "sunny-no-reflections" (céu azul com luz suave e uniforme — ideal para exteriores em sombra ou orientados a norte), "sunrise" (manhã dourada e quente), "dawn" (tons de pôr do sol / anoitecer), "night" (crepúsculo com luz quente interior e de fachada).
Values: sunny sunny-no-reflections sunrise dawn night
Default: sunny
propertyIdstring
Id opcional da propriedade (de list_properties ou create_property) a que esta foto pertence. Quando definido, o resultado é guardado na galeria dessa propriedade — visível e editável a partir da app — em vez de ser apenas devolvido como URL.

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",
    "skyStyle": "sunny"
  }'

Resposta de exemplo

JSON
{
  "message": "Success",
  "output": {
    "url": "https://img.pedra.ai/<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".
propertyIdstring
Id opcional da propriedade (de list_properties ou create_property) a que esta foto pertence. Quando definido, o resultado é guardado na galeria dessa propriedade — visível e editável a partir da app — em vez de ser apenas devolvido como URL.

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://img.pedra.ai/<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.