Zestio API Reference

Precision gestaltet den Raum neu — ob leer oder möbliert — in zwei Zonen: Die Fix-Zone (Fenster, Türen, Vorhänge, Außenbereiche wie Balkon/Terrasse) wird 1:1 vom Original übernommen; die Edit-Zone (Möbel, Deko, Wände, Decke) darf gestaltet werden — Wände dürfen gestrichen oder mit Wandpaneelen ausgestattet werden, die Decke eine Lampe bekommen. Der Fußboden ist Teil der Maske (damit Möbel vollständig gezeichnet werden) und wird anschließend 1:1 aus dem Original zurückgeführt(Floor-Restore) — der sichtbare Boden ist immer exakt das Original, inklusive Schatten & Möbelfüßen, die darüber liegen. Lichtschalter/Steckdosen werden über eine feste Prompt-Instruktion geschützt (keine ADE20K-Klasse → kein Masken-Schutz). Die Verarbeitung läuft asynchron:

1. POST /api/staging mit model: "precision" → Antwort enthält eine jobId
2. Klassenbasierte Segmentierung (SegFormer): Fenster, Türen & Außenbereiche werden automatisch erkannt (Fix-Zone); Innen-Struktur-Anteil wird geprüft — reine Außenaufnahmen brechen ab („Kein Innenraum erkannt")
3. Zonen-Maske: Alles außer der Fix-Zone wird einrichtbare Fläche — Möbel, Wände (streichen/Paneele), Decke (Lampe) und Boden (damit Möbel vollständig gezeichnet werden)
4. Masked Inpainting (flux-fill-pro): Nur die maskierten Bereiche werden neu gestaltet — mit Instruktionen: Boden 1:1 lassen, Schalter/Steckdosen unverändert, Wände frisch streichen, Lampe ergänzen
5. Floor-Restore: Ein zweiter SegFormer-Lauf erkennt den sichtbaren Boden im Inpaint-Ergebnis und führt ihn pixelgenau aus dem Original zurück — Möbel & Schatten bleiben darüber stehen
6. Hard-Composite: Fix-Zone (Fenster/Türen/Außen) pixelgenau vom Original
7. GET /api/staging/poll?jobId=<id> pollen, bis status: "completed" (typische Dauer ~1–2,5 Min)

# 1) Job starten
curl -X POST https://zestio.de/api/staging \
  -H "Authorization: Bearer ***" -H "Content-Type: application/json" \
  -d '{"image":"https://example.com/room.jpg","model":"precision","roomType":"living","furnitureStyle":"modern"}'

# → { "status": "processing", "stage": "mask", "jobId": "uuid", "maskPredictionId": "..." }

# 2) Fortschritt abfragen (alle ~5 s)
curl "https://zestio.de/api/staging/poll?jobId=uuid" -H "Authorization: Bearer ***"

# → { "status": "completed", "output": "https://...result.jpg", "stats": { "maskCoverage": 0.75, "structureCoverage": 0.35, "floorCoverage": 0.92 } }
#   Fehler: { "status": "failed", "error": "..." } — Rate-Limits (429) werden automatisch retried,
#   Außenaufnahmen ohne Innen-Struktur brechen mit klarer Meldung ab ("Kein Innenraum erkannt")

Fortschritt: mask → inpaint → floor → completed. Die Job-Metadaten enthalten die Zonen-Analyse (maskCoverage = Edit-Zone/einrichtbare Fläche,structureCoverage = erkannte Innen-Struktur (Guard-Basis, Außenaufnahmen),protectedLabels = erkannte Fix-Zonen-Klassen,floorCoverage = Anteil des 1:1 zurückgeführten Bodens, floorPreserved= Floor-Restore aktiv) und die Pixel-Differenz außerhalb der Maske — dein Nachweis, dass Fenster & Außenbereiche unangetastet blieben. Jobs, die länger als 10 Minuten ohne Fortschritt hängen, werden automatisch als fehlgeschlagen markiert.