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. Quando è true, preserveOriginalFraming viene ignorato.
Default: false
preserveOriginalFramingboolean
Mantiene esattamente inquadratura, aspect ratio e risoluzione originali (senza ritaglio dei bordi). Il miglioramento è comunque generato dall'IA, quindi colori e materiali possono variare leggermente — se devono restare identici, usa highFidelity. Ignorato quando highFidelity è true.
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.

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. Quando è true, preserveOriginalFraming viene ignorato.
Default: false
preserveOriginalFramingboolean
Preserva esattamente inquadratura, aspect ratio e risoluzione dell'input (senza ritaglio dei bordi) correggendo la prospettiva. Il miglioramento è comunque generato dall'IA, quindi colori e materiali possono variare leggermente — usa highFidelity se devono restare identici. Ignorato quando highFidelity è true.
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.

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
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.

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".
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.

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.