Home staging virtuale

API home staging virtuale

Arreda stanze vuote, svuota stanze arredate, rinnova spazi e modifica interni con prompt o maschere — tutte le operazioni sui contenuti delle stanze in un'unica API.

Gli endpoint di home staging virtuale coprono tutto ciò che cambia il contenuto di una stanza: aggiungere mobili, rimuoverli, rinnovare lo spazio, modifiche precise via prompt e rimozione di oggetti tramite maschera. Per la pulizia delle foto (enhance, sky, blur), vedi Miglioramento immagini.

Arredare una stanza vuota

POST/api/furnish

Aggiunge mobili realistici in una stanza vuota. Pedra preserva l'architettura della stanza (pareti, finestre, porte, pavimenti) e aggiunge solo mobili e decorazione.

Esempi di staging di interni
Coppie prima/dopo in soggiorni, camere, cucine e uffici in diversi stili d'arredamento.
Vedi esempi →

Parametri

apiKeystringobbligatorio
La tua chiave API.
imageUrlstringobbligatorio
URL della foto della stanza vuota, o un data URI base64 (data:image/png;base64,...).
roomTypestringobbligatorio
Tipo di spazio da arredare. Gli otto valori sottostanti sono i tipi di spazio predefiniti. Puoi anche passare qualsiasi altro spazio come stringa personalizzata (es. "Kid's room", "Garden", "Home gym").
Values: Living room Dining + Living room Bedroom Dining room Terrace Entrance Office Bathroom
stylestringobbligatorio
Stile del mobilio. Passa uno degli stili nominati sotto o un URL pubblico a un'immagine di riferimento (es. una foto Pinterest o di prodotto) — Pedra replicherà il look del riferimento.
Values: Minimalist Modern Scandinavian Industrial Bohemian Mid-century modern Traditional Mediterranean Coastal Rustic Farmhouse Contemporary
creativitystring
Deprecato e ignorato da settembre 2026. L'arredamento ha ora un solo livello: aggiunge mobili e decorazioni mantenendo pareti, porte, finestre e angolo di ripresa esattamente come sono, a 1 credito per immagine (2 se style è l'URL di un'immagine di riferimento). Le richieste che inviano ancora questo parametro continuano a funzionare.
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/furnish \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "imageUrl": "https://example.com/empty-bedroom.jpg",
    "roomType": "Bedroom",
    "style": "Minimalist"
  }'

Risposta di esempio

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

Tempo di risposta: ~30 secondi per immagine.

Svuotare una stanza arredata

POST/api/empty_room

Rimuove mobili e oggetti da una stanza lasciando intatta l'architettura. Utile quando le foto dell'annuncio sono scattate con gli oggetti del precedente proprietario ancora al loro posto.

Esempi di decluttering e svuotamento stanze
Guarda annunci reali trasformati da disordinati a completamente vuoti in pochi secondi.
Vedi esempi →

Parametri

apiKeystringobbligatorio
La tua chiave API.
imageUrlstringobbligatorio
URL della foto della stanza arredata, o un data URI base64.
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/empty_room \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "imageUrl": "https://example.com/furnished-room.jpg"
  }'

Risposta di esempio

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

Tempo di risposta: ~30 secondi per immagine.

Rinnovare una stanza

POST/api/renovation

Mostra come potrebbe apparire una stanza dopo la ristrutturazione: nuove finiture, cucine aggiornate, bagni rinnovati. Opzionalmente mantiene le finestre al loro posto e riarreda nella stessa chiamata.

Esempi di rinnovazione virtuale
Render reali di ristrutturazione — cucine datate, bagni stanchi e interni rinnovati in vari stili.
Vedi esempi →

Parametri

apiKeystringobbligatorio
La tua chiave API.
imageUrlstringobbligatorio
URL della foto della stanza da rinnovare.
stylestringobbligatorio
Stile della ristrutturazione. Passa uno degli stili nominati sotto o un URL pubblico a un'immagine di riferimento — Pedra replica finiture, palette e look generale del riferimento.
Values: Minimalist Modern Scandinavian Industrial Bohemian Mid-century modern Traditional Mediterranean Coastal Rustic Farmhouse Contemporary
preserveWindowsboolean
Mantiene le finestre nella posizione originale. Consigliato per annunci accurati.
Default: false
furnishboolean
Aggiunge mobili alla stanza rinnovata nella stessa chiamata. Quando true, roomType è obbligatorio.
Default: false
roomTypestring
Usato quando furnish è true. Predefinito "Auto" (Pedra rileva lo spazio dall'immagine). Accetta gli stessi tipi di spazio predefiniti dell'endpoint furnish, oltre a qualsiasi spazio personalizzato che scrivi come stringa (es. "Kid's room", "Garden", "Home gym").
Values: Living room Dining + Living room Bedroom Dining room Terrace Entrance Office Bathroom Auto
Default: Auto
creativitystring
Deprecato e ignorato da settembre 2026. La ristrutturazione ha ora un solo livello: rinnova finiture, materiali e arredi mantenendo pareti, porte, finestre e angolo di ripresa esattamente come sono, a 1 credito per immagine. Le richieste che inviano ancora questo parametro continuano a funzionare.
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/renovation \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "imageUrl": "https://example.com/dated-kitchen.jpg",
    "style": "Modern",
    "preserveWindows": true,
    "furnish": true,
    "roomType": "Kitchen"
  }'

Risposta di esempio

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

Tempo di risposta: ~30 secondi per immagine.

Modifica con prompt

POST/api/edit_via_prompt

Fai modifiche mirate descritte in linguaggio naturale: "Add a modern chandelier", "Repaint the walls white", "Remove the rug". Ideale per correzioni occasionali che non rientrano negli altri endpoint.

Parametri

apiKeystringobbligatorio
La tua chiave API.
imageUrlstringobbligatorio
URL della foto da modificare, o un data URI base64.
promptstringobbligatorio
Istruzione di modifica in linguaggio naturale. Sii specifico — "add a beige sofa against the back wall" funziona meglio di "add furniture".
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/edit_via_prompt \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "imageUrl": "https://example.com/living-room.jpg",
    "prompt": "Add a modern chandelier to the ceiling"
  }'

Risposta di esempio

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

Tempo di risposta: ~15 secondi per immagine. Costo: 2 crediti per chiamata. output è un singolo oggetto.

Rimuovi oggetto

POST/api/remove_object

Rimuove oggetti specifici da un'immagine usando una maschera. La maschera è un'immagine separata dove i pixel bianchi indicano cosa rimuovere e quelli neri cosa mantenere. Usalo quando ti serve controllo chirurgico rispetto a edit_via_prompt.

Esempi di rimozione oggetti
Stessa galleria di /api/empty_room — disordine, mobili e oggetti rimossi da vere foto di annunci.
Vedi esempi →

Parametri

apiKeystringobbligatorio
La tua chiave API.
imageUrlstringobbligatorio
URL della foto sorgente.
maskUrlstringobbligatorio
URL dell'immagine maschera. Le aree bianche vengono rimosse; le aree nere vengono mantenute.
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/remove_object \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "imageUrl": "https://example.com/cluttered-room.jpg",
    "maskUrl": "https://example.com/mask.png"
  }'

Risposta di esempio

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

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

Successivo

Vedi Miglioramento immagini per nitidezza, sostituzione cielo e sfocatura — o Errori e limiti per la gestione degli errori.