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.
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. Quando é true, preserveOriginalFraming é ignorado.
Default:false
preserveOriginalFramingboolean
Mantém o enquadramento, o aspect ratio e a resolução originais exatos (sem corte de bordas). A melhoria continua a ser gerada por IA, pelo que as cores e materiais podem variar ligeiramente — se tiverem de permanecer idênticos, usa highFidelity. Ignorado quando highFidelity é true.
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.
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.
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. Quando é true, preserveOriginalFraming é ignorado.
Default:false
preserveOriginalFramingboolean
Preserva exatamente o enquadramento, o aspect ratio e a resolução da entrada (sem corte de bordas) ao corrigir a perspetiva. A melhoria continua a ser gerada por IA, pelo que as cores e materiais podem variar ligeiramente — usa highFidelity se tiverem de permanecer idênticos. Ignorado quando highFidelity é true.
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).
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:sunnysunny-no-reflectionssunrisedawnnight
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.
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.
