Miglioramento immagini

API per il miglioramento delle immagini

Miglioramento automatico, correzione prospettica, sostituzione del cielo e sfocatura — endpoint per pulire foto immobiliari.

Gli endpoint di miglioramento immagini risolvono problemi comuni delle foto di annunci: illuminazione spenta, prospettiva inclinata, cieli grigi e contenuti sensibili alla privacy. Ognuno accetta un URL di immagine e restituisce il risultato elaborato.

Miglioramento automatico

POST/api/enhance

Migliora automaticamente illuminazione, bilanciamento colore, nitidezza e contrasto. Usalo come passo di pulizia predefinito sulle foto di annunci grezze.

Esempi di miglioramento immagini
Foto reali di annunci prima e dopo il passaggio enhance — stanze buie, colori spenti, fuoco morbido.
Vedi esempi →

Parametri

apiKeystringobbligatorio
La tua chiave API.
imageUrlstringobbligatorio
URL della foto da migliorare, o un data URI base64.
highFidelityboolean
Miglioramento non generativo: regola solo luce e nitidezza, mantenendo colori, materiali, dimensioni degli oggetti e inquadratura esattamente come nella foto originale. Ideale quando il risultato deve restare fedele all'originale.
Default: false
preserveAspectRatioboolean
Per impostazione predefinita, il risultato viene restituito nella dimensione prodotta dal modello di IA, che potrebbe non corrispondere all'aspect ratio né alla risoluzione della tua foto. Impostalo a true per ricevere il risultato con la larghezza e l'altezza esatte dell'immagine inviata: viene ritagliato al centro sull'aspect ratio originale (mai deformato) e ridimensionato alla risoluzione originale.
Default: false
propertyIdstring
Id opzionale della proprietà (da list_properties o create_property) a cui appartiene questa foto. Se impostato, il risultato viene salvato nella galleria di quella proprietà — visibile e modificabile dall'app — invece di essere restituito solo come URL. La risposta include anche <code>source</code> (<code>imageId</code> e <code>name</code>) della foto originale, se è già in quella proprietà o se invii anche <code>name</code>.
namestring
Nome opzionale per la foto originale (ad es. il nome del file), fino a 200 caratteri. Richiede <code>propertyId</code>. Se la foto non è ancora in quella proprietà, viene salvata lì con questo nome nella stessa chiamata, quindi non serve chiamare prima <code>add_images_to_property</code>, e il nome viene restituito come <code>source.name</code>. Una foto già presente nella proprietà mantiene il suo nome. Non compare mai sull'immagine.

Richiesta di esempio

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
  }'

Risposta di esempio

JSON
{
  "message": "Success",
  "output": [
    { "url": "https://img.pedra.ai/<generated-id>" }
  ]
}

Tempo di risposta: ~10 secondi per immagine. La risposta può includere più URL quando il modello produce varianti.

Migliora + correggi prospettiva

POST/api/enhance_and_correct_perspective

Come /api/enhance ma con un passaggio di correzione prospettica iniziale che raddrizza le linee verticali. Usalo quando le foto dell'annuncio sono state scattate con un telefono inclinato.

Esempi di miglioramento immagini
Stessa galleria di /api/enhance — la correzione prospettica è più visibile sugli esterni inclinati.
Vedi esempi →

Parametri

apiKeystringobbligatorio
La tua chiave API.
imageUrlstringobbligatorio
URL della foto, o un data URI base64.
highFidelityboolean
Miglioramento non generativo con correzione della prospettiva: regola solo luce, nitidezza e prospettiva, mantenendo colori, materiali e dimensioni degli oggetti esattamente come nell'originale.
Default: false
preserveAspectRatioboolean
Per impostazione predefinita, il risultato viene restituito nella dimensione prodotta dal modello di IA, che potrebbe non corrispondere all'aspect ratio né alla risoluzione della tua foto. Impostalo a true per ricevere il risultato con la larghezza e l'altezza esatte dell'immagine inviata: viene ritagliato al centro sull'aspect ratio originale (mai deformato) e ridimensionato alla risoluzione originale.
Default: false
propertyIdstring
Id opzionale della proprietà (da list_properties o create_property) a cui appartiene questa foto. Se impostato, il risultato viene salvato nella galleria di quella proprietà — visibile e modificabile dall'app — invece di essere restituito solo come URL. La risposta include anche <code>source</code> (<code>imageId</code> e <code>name</code>) della foto originale, se è già in quella proprietà o se invii anche <code>name</code>.
namestring
Nome opzionale per la foto originale (ad es. il nome del file), fino a 200 caratteri. Richiede <code>propertyId</code>. Se la foto non è ancora in quella proprietà, viene salvata lì con questo nome nella stessa chiamata, quindi non serve chiamare prima <code>add_images_to_property</code>, e il nome viene restituito come <code>source.name</code>. Una foto già presente nella proprietà mantiene il suo nome. Non compare mai sull'immagine.

Formato di risposta: uguale a /api/enhance (array). Tempo di risposta: ~15 secondi per immagine.

Sostituzione del cielo

POST/api/sky_blue

Sostituisce un cielo grigio, nuvoloso o slavato e migliora l'illuminazione. Predefinito un cielo azzurro pulito; usa skyStyle per scegliere un altro momento della giornata (alba, tramonto, notte).

Esempi di miglioramento immagini
Esterni nuvolosi trasformati in foto di annunci con cielo azzurro pulito.
Vedi esempi →

Parametri

apiKeystringobbligatorio
La tua chiave API.
imageUrlstringobbligatorio
URL della foto esterna, o un data URI base64.
skyStylestring
Quale cielo e illuminazione applicare. Predefinito "sunny". Opzioni: "sunny" (cielo azzurro limpido e luminoso), "sunny-no-reflections" (cielo azzurro con luce morbida e uniforme — ideale per esterni in ombra o esposti a nord), "sunrise" (mattino dorato e caldo), "dawn" (tonalità di tramonto / crepuscolo), "night" (crepuscolo con luce calda interna e di facciata).
Values: sunny sunny-no-reflections sunrise dawn night
Default: sunny
preserveAspectRatioboolean
Per impostazione predefinita, il risultato viene restituito nella dimensione prodotta dal modello di IA, che potrebbe non corrispondere all'aspect ratio né alla risoluzione della tua foto. Impostalo a true per ricevere il risultato con la larghezza e l'altezza esatte dell'immagine inviata: viene ritagliato al centro sull'aspect ratio originale (mai deformato) e ridimensionato alla risoluzione originale.
Default: false
propertyIdstring
Id opzionale della proprietà (da list_properties o create_property) a cui appartiene questa foto. Se impostato, il risultato viene salvato nella galleria di quella proprietà — visibile e modificabile dall'app — invece di essere restituito solo come URL. La risposta include anche <code>source</code> (<code>imageId</code> e <code>name</code>) della foto originale, se è già in quella proprietà o se invii anche <code>name</code>.
namestring
Nome opzionale per la foto originale (ad es. il nome del file), fino a 200 caratteri. Richiede <code>propertyId</code>. Se la foto non è ancora in quella proprietà, viene salvata lì con questo nome nella stessa chiamata, quindi non serve chiamare prima <code>add_images_to_property</code>, e il nome viene restituito come <code>source.name</code>. Una foto già presente nella proprietà mantiene il suo nome. Non compare mai sull'immagine.

Richiesta di esempio

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"
  }'

Risposta di esempio

JSON
{
  "message": "Success",
  "output": {
    "url": "https://img.pedra.ai/<generated-id>"
  }
}

Tempo di risposta: ~10 secondi per immagine. Nota: qui output è un singolo oggetto, non un array.

Sfocare oggetti

POST/api/blur

Sfoca automaticamente contenuti sensibili come volti, targhe o loghi. Utile per foto esterne conformi ai portali.

Parametri

apiKeystringobbligatorio
La tua chiave API.
imageUrlstringobbligatorio
URL della foto sorgente.
objectsToBlurstringobbligatorio
Elenco separato da virgole di cosa sfocare. Esempi: "faces", "license plates", "logos", "faces, license plates".
preserveAspectRatioboolean
Per impostazione predefinita, il risultato viene restituito nella dimensione prodotta dal modello di IA, che potrebbe non corrispondere all'aspect ratio né alla risoluzione della tua foto. Impostalo a true per ricevere il risultato con la larghezza e l'altezza esatte dell'immagine inviata: viene ritagliato al centro sull'aspect ratio originale (mai deformato) e ridimensionato alla risoluzione originale.
Default: false
propertyIdstring
Id opzionale della proprietà (da list_properties o create_property) a cui appartiene questa foto. Se impostato, il risultato viene salvato nella galleria di quella proprietà — visibile e modificabile dall'app — invece di essere restituito solo come URL. La risposta include anche <code>source</code> (<code>imageId</code> e <code>name</code>) della foto originale, se è già in quella proprietà o se invii anche <code>name</code>.
namestring
Nome opzionale per la foto originale (ad es. il nome del file), fino a 200 caratteri. Richiede <code>propertyId</code>. Se la foto non è ancora in quella proprietà, viene salvata lì con questo nome nella stessa chiamata, quindi non serve chiamare prima <code>add_images_to_property</code>, e il nome viene restituito come <code>source.name</code>. Una foto già presente nella proprietà mantiene il suo nome. Non compare mai sull'immagine.

Richiesta di esempio

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"
  }'

Risposta di esempio

JSON
{
  "message": "Success",
  "output": {
    "url": "https://img.pedra.ai/<generated-id>"
  }
}

Tempo di risposta: ~10 secondi per immagine. output è un singolo oggetto.

Successivo

Vedi Home staging virtuale per modifiche a mobili e contenuti, o Crea video per generare video di annunci da foto.