Generazione di immagini
Trasforma una fotografia che hai già caricato: allestisci una stanza vuota, elimina il disordine o correggi il modo in cui è stata scattata. Ogni richiesta viene messa in coda e prodotta in secondo piano.
/v1/api/generations/kindsimages:writeElencare cosa si può generare
Le trasformazioni disponibili, e cosa fa ciascuna.
Servito dallo stesso elenco su cui l'API effettua la validazione, quindi non può restare indietro. Indica anche cosa deliberatamente non è disponibile e perché, il che è più utile di un'assenza da dedurre.
Risposta
{
"data": {
"kinds": [
{
"kind": "virtual_staging",
"description": "Furnish an empty room in a chosen style, leaving the architecture untouched."
},
{
"kind": "decluttering",
"description": "Remove personal clutter from a room without changing the furniture or the fabric of the building."
},
{
"kind": "enhancement",
"description": "Correct exposure, white balance, and straightness, without altering what the photograph shows."
}
],
"not_available": [
{
"kind": "floorplan_render",
"reason": "Named in the schema and not implemented. Rendering a floor plan needs a provider we have not integrated, and a plausible but wrong plan of somebody's home is worse than none."
}
]
}
}https://api.skautik.com/v1/api/generations/kinds
GET /v1/api/generations/kinds HTTP/1.1
Host: api.skautik.com
Authorization: Bearer sk_live_…/v1/api/generationsimages:writeRichiedere una generazione
Metti in coda la trasformazione di una delle tue immagini di immobile.
Restituisce subito una generazione in coda. Interroga l'endpoint di recupero, oppure iscriviti a un webhook, invece di tenere aperta la richiesta. L'immagine di origine deve già appartenere a uno dei tuoi immobili: non c'è modo di inviare un URL qualsiasi, ed è voluto.
Campi del corpo
| Nome | Tipo | Descrizione |
|---|---|---|
kindobbligatorio | enum | La trasformazione da applicare. floorplan_render è nominato nello schema e non è implementato; chiederlo viene rifiutato invece di ricevere una planimetria inventata. virtual_staging | decluttering | enhancement esempio: virtual_staging |
source_image_idobbligatorio | string | L'immagine da trasformare. Deve appartenere a uno dei tuoi immobili; qualsiasi altra cosa risponde 404, come un'immagine che non esiste. esempio: img_ce1c9e04db6140eda7c6934af60daebb |
room_type | string | Per virtual_staging: di che stanza si tratta. Migliora sensibilmente il risultato. Per impostazione predefinita, una stanza generica. esempio: living room |
style | string | Per virtual_staging: lo stile dell'arredo. Per impostazione predefinita, contemporaneo. esempio: scandinavian |
prompt | string | Fino a 500 caratteri di indicazioni aggiuntive. Vengono aggiunte all'istruzione del tipo scelto e non la sostituiscono mai, quindi non si possono usare per far fare al modello qualcosa di estraneo. esempio: A bright Scandinavian living room with oak floors and a linen sofa |
Corpo della richiesta
{
"kind": "virtual_staging",
"source_image_id": "img_ce1c9e04db6140eda7c6934af60daebb",
"room_type": "living room",
"style": "scandinavian"
}Risposta
{
"data": {
"id": "gen_41bd169388ff4bee8706b822e4def3c5",
"kind": "virtual_staging",
"status": "queued",
"property_id": "prop_f06bd367019344dd91b559046f8e0d4c",
"source_image_id": "img_ce1c9e04db6140eda7c6934af60daebb",
"style": "scandinavian",
"room_type": "living room",
"created_at": "2026-08-13T14:39:51Z"
}
}Risposte degne di nota
- 404
- L'immagine di origine non esiste, oppure non appartiene a uno dei tuoi immobili. Le due cose sono indistinguibili di proposito.
https://api.skautik.com/v1/api/generations
POST /v1/api/generations HTTP/1.1
Host: api.skautik.com
Authorization: Bearer sk_live_…
Content-Type: application/json
{
"kind": "virtual_staging",
"source_image_id": "img_ce1c9e04db6140eda7c6934af60daebb",
"room_type": "living room",
"style": "scandinavian"
}/v1/api/generations/{generation_id}images:writeRecuperare una generazione
Stato, e l'immagine una volta pronta.
Passa per in coda, in esecuzione e poi completata o fallita. Una generazione fallita riporta il motivo, compreso il caso in cui il modello si è rifiutato invece di dare errore: sono problemi diversi e solo uno vale la pena riprovarlo.
Parametri di percorso
| Nome | Tipo | Descrizione |
|---|---|---|
generation_idobbligatorio | string | Identificatore della generazione. esempio: gen_5c1e9a2b3d |
Risposta
{
"data": {
"id": "gen_41bd169388ff4bee8706b822e4def3c5",
"kind": "virtual_staging",
"status": "completed",
"property_id": "prop_f06bd367019344dd91b559046f8e0d4c",
"source_image_id": "img_ce1c9e04db6140eda7c6934af60daebb",
"style": "scandinavian",
"room_type": "living room",
"image_url": "https://images.skautik.com/generations/…/41bd1693.jpg",
"created_at": "2026-08-13T14:39:51Z",
"finished_at": "2026-08-13T14:40:07Z"
}
}https://api.skautik.com/v1/api/generations/{generation_id}
GET /v1/api/generations/gen_5c1e9a2b3d HTTP/1.1
Host: api.skautik.com
Authorization: Bearer sk_live_…/v1/api/generationsimages:writeElencare le generazioni
Richieste recenti della tua organizzazione, dalla più recente.
https://api.skautik.com/v1/api/generations
GET /v1/api/generations HTTP/1.1
Host: api.skautik.com
Authorization: Bearer sk_live_…