Bildgenerierungen
Ein bereits hochgeladenes Foto verwandeln: einen leeren Raum einrichten, Unordnung entfernen oder korrigieren, wie ein Bild aufgenommen wurde. Jede Anfrage wird in die Warteschlange gestellt und im Hintergrund erzeugt.
/v1/api/generations/kindsimages:writeAuflisten, was erzeugt werden kann
Die verfügbaren Umwandlungen, und was jede bewirkt.
Wird aus derselben Liste bedient, gegen die die API prüft, kann also nicht zurückbleiben. Sie benennt außerdem, was bewusst nicht verfügbar ist und warum, was nützlicher ist als eine Abwesenheit, die man sich erschließen muss.
Antwort
{
"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:writeEine Generierung anfordern
Eine Umwandlung eines Ihrer Objektbilder in die Warteschlange stellen.
Kommt sofort mit einer wartenden Generierung zurück. Fragen Sie den Abruf-Endpunkt ab oder abonnieren Sie einen Webhook, statt die Anfrage offen zu halten. Das Ausgangsbild muss bereits zu einem Ihrer Objekte gehören: Eine beliebige URL einzureichen ist nicht möglich, und das ist Absicht.
Felder im Rumpf
| Name | Typ | Beschreibung |
|---|---|---|
kinderforderlich | enum | Die anzuwendende Umwandlung. floorplan_render ist im Schema benannt und nicht umgesetzt; danach zu fragen wird abgelehnt, statt mit einem erfundenen Grundriss beantwortet zu werden. virtual_staging | decluttering | enhancement Beispiel: virtual_staging |
source_image_iderforderlich | string | Das umzuwandelnde Bild. Muss zu einem Ihrer eigenen Objekte gehören; alles andere antwortet mit 404, genau wie ein Bild, das es nicht gibt. Beispiel: img_ce1c9e04db6140eda7c6934af60daebb |
room_type | string | Für virtual_staging: was der Raum ist. Verbessert das Ergebnis deutlich. Voreingestellt ist ein allgemeiner Raum. Beispiel: living room |
style | string | Für virtual_staging: der Einrichtungsstil. Voreingestellt ist zeitgenössisch. Beispiel: scandinavian |
prompt | string | Bis zu 500 Zeichen zusätzliche Anweisung. Sie wird der Anweisung für die gewählte Art hinzugefügt und ersetzt sie nie, sie lässt sich also nicht nutzen, um das Modell zu etwas Fremdem zu bewegen. Beispiel: A bright Scandinavian living room with oak floors and a linen sofa |
Rumpf der Anfrage
{
"kind": "virtual_staging",
"source_image_id": "img_ce1c9e04db6140eda7c6934af60daebb",
"room_type": "living room",
"style": "scandinavian"
}Antwort
{
"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"
}
}Bemerkenswerte Antworten
- 404
- Das Ausgangsbild existiert nicht oder gehört zu keinem Ihrer Objekte. Die beiden Fälle sind absichtlich nicht zu unterscheiden.
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:writeEine Generierung abrufen
Status, und das Bild, sobald es fertig ist.
Durchläuft queued, running und dann completed oder failed. Eine fehlgeschlagene Generierung trägt den Grund, auch wenn das Modell abgelehnt statt gescheitert ist: Das sind verschiedene Probleme, und nur eines lohnt einen erneuten Versuch.
Pfadparameter
| Name | Typ | Beschreibung |
|---|---|---|
generation_iderforderlich | string | Generierungskennung. Beispiel: gen_5c1e9a2b3d |
Antwort
{
"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:writeGenerierungen auflisten
Letzte Anfragen Ihrer Organisation, neueste zuerst.
https://api.skautik.com/v1/api/generations
GET /v1/api/generations HTTP/1.1
Host: api.skautik.com
Authorization: Bearer sk_live_…