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 stanza da arredare. Gli otto valori sottostanti hanno prompt curati a mano; qualsiasi altra stringa (es. "Kitchen", "Closet") funziona anche tramite prompt auto-generati.
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
Quanta libertà prende l'IA con il design. Medium è il valore predefinito raccomandato; High usa un modello più leggero e veloce. Medium costa 2 crediti per immagine, High costa 1 — vedi Prezzi.
Values: Medium High
Default: Medium

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",
    "creativity": "Medium"
  }'

Risposta di esempio

JSON
{
  "message": "Success",
  "output": [
    { "url": "https://pedraimages.s3.eu-west-3.amazonaws.com/<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.

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://pedraimages.s3.eu-west-3.amazonaws.com/<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 la stanza dall'immagine). Stesso insieme di valori dell'endpoint furnish.
Values: Living room Dining + Living room Bedroom Dining room Terrace Entrance Office Bathroom Auto
Default: Auto
creativitystring
Quanto è aggressiva la ristrutturazione. Medium è il valore predefinito raccomandato; High usa un modello più leggero e veloce. Medium costa 2 crediti per immagine, High costa 1 — vedi Prezzi.
Values: Medium High
Default: Medium

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",
    "creativity": "Medium"
  }'

Risposta di esempio

JSON
{
  "message": "Success",
  "output": [
    { "url": "https://pedraimages.s3.eu-west-3.amazonaws.com/<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".

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://pedraimages.s3.eu-west-3.amazonaws.com/<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.

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://pedraimages.s3.eu-west-3.amazonaws.com/<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.