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.
highFidelityboolean
Melhoria não generativa: ajusta apenas a luz e a nitidez, mantendo as cores, os materiais, o tamanho dos objetos e o enquadramento exatamente como na foto original. Ideal quando o resultado tem de ser fiel ao original.
Default: false
preserveAspectRatioboolean
Por defeito, o resultado é devolvido no tamanho que o modelo de IA produzir, que pode não coincidir com o aspect ratio nem com a resolução da tua foto. Define-o como true para receber o resultado com a largura e a altura exatas da imagem de entrada: é recortado a partir do centro para o aspect ratio original (nunca esticado) e redimensionado para a resolução original.
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. A resposta inclui também <code>source</code> (<code>imageId</code> e <code>name</code>) da foto original, se já estiver nessa propriedade ou se enviares também <code>name</code>.
namestring
Nome opcional para a foto original (p. ex. o nome do ficheiro), até 200 caracteres. Requer <code>propertyId</code>. Se a foto ainda não estiver nessa propriedade, é guardada lá com este nome na mesma chamada, por isso não precisas de chamar antes <code>add_images_to_property</code>, e o nome é devolvido como <code>source.name</code>. Uma foto que já está na propriedade mantém o seu nome. Nunca aparece na imagem.

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",
    "highFidelity": 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.
highFidelityboolean
Melhoria não generativa com correção de perspetiva: ajusta apenas a luz, a nitidez e a perspetiva, mantendo as cores, os materiais e o tamanho dos objetos exatamente como no original.
Default: false
preserveAspectRatioboolean
Por defeito, o resultado é devolvido no tamanho que o modelo de IA produzir, que pode não coincidir com o aspect ratio nem com a resolução da tua foto. Define-o como true para receber o resultado com a largura e a altura exatas da imagem de entrada: é recortado a partir do centro para o aspect ratio original (nunca esticado) e redimensionado para a resolução original.
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. A resposta inclui também <code>source</code> (<code>imageId</code> e <code>name</code>) da foto original, se já estiver nessa propriedade ou se enviares também <code>name</code>.
namestring
Nome opcional para a foto original (p. ex. o nome do ficheiro), até 200 caracteres. Requer <code>propertyId</code>. Se a foto ainda não estiver nessa propriedade, é guardada lá com este nome na mesma chamada, por isso não precisas de chamar antes <code>add_images_to_property</code>, e o nome é devolvido como <code>source.name</code>. Uma foto que já está na propriedade mantém o seu nome. Nunca aparece na imagem.

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
preserveAspectRatioboolean
Por defeito, o resultado é devolvido no tamanho que o modelo de IA produzir, que pode não coincidir com o aspect ratio nem com a resolução da tua foto. Define-o como true para receber o resultado com a largura e a altura exatas da imagem de entrada: é recortado a partir do centro para o aspect ratio original (nunca esticado) e redimensionado para a resolução original.
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. A resposta inclui também <code>source</code> (<code>imageId</code> e <code>name</code>) da foto original, se já estiver nessa propriedade ou se enviares também <code>name</code>.
namestring
Nome opcional para a foto original (p. ex. o nome do ficheiro), até 200 caracteres. Requer <code>propertyId</code>. Se a foto ainda não estiver nessa propriedade, é guardada lá com este nome na mesma chamada, por isso não precisas de chamar antes <code>add_images_to_property</code>, e o nome é devolvido como <code>source.name</code>. Uma foto que já está na propriedade mantém o seu nome. Nunca aparece na imagem.

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".
preserveAspectRatioboolean
Por defeito, o resultado é devolvido no tamanho que o modelo de IA produzir, que pode não coincidir com o aspect ratio nem com a resolução da tua foto. Define-o como true para receber o resultado com a largura e a altura exatas da imagem de entrada: é recortado a partir do centro para o aspect ratio original (nunca esticado) e redimensionado para a resolução original.
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. A resposta inclui também <code>source</code> (<code>imageId</code> e <code>name</code>) da foto original, se já estiver nessa propriedade ou se enviares também <code>name</code>.
namestring
Nome opcional para a foto original (p. ex. o nome do ficheiro), até 200 caracteres. Requer <code>propertyId</code>. Se a foto ainda não estiver nessa propriedade, é guardada lá com este nome na mesma chamada, por isso não precisas de chamar antes <code>add_images_to_property</code>, e o nome é devolvido como <code>source.name</code>. Uma foto que já está na propriedade mantém o seu nome. Nunca aparece na imagem.

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.