Zestio API Reference

Precision redesigns the room — empty or furnished — in two zones: the fix zone (windows, doors, curtains, outdoor areas such as balcony/terrace) is taken 1:1 from the original; the edit zone (furniture, decor, walls, ceiling) may be redesigned — walls can be painted or fitted with wall panels, the ceiling can get a lamp. The floor is part of the mask (so furniture is drawn completely) and is then restored 1:1 from the original (floor restore) — the visible floor is always exactly the original, including shadows & furniture feet lying on top. Light switches/sockets are protected by a fixed prompt instruction (no ADE20K class → no mask protection). Processing runs asynchronously:

1. POST /api/staging with model: "precision" → the response contains a jobId
2. Class-based segmentation (SegFormer): windows, doors & outdoor areas are detected automatically (fix zone); the interior structure share is checked — pure exterior shots abort („Kein Innenraum erkannt")
3. Zone mask: everything outside the fix zone becomes furnishable area — furniture, walls (paint/panels), ceiling (lamp) and floor (so furniture is drawn completely)
4. Masked inpainting (flux-fill-pro): only the masked areas are redesigned — with instructions: keep the floor 1:1, switches/sockets unchanged, paint walls fresh, add a lamp
5. Floor restore: a second SegFormer run detects the visible floor in the inpaint result and restores it pixel-exactly from the original — furniture & shadows stay on top
6. Hard composite: fix zone (windows/doors/outdoor) pixel-exact from the original
7. GET /api/staging/poll?jobId=<id> until status: "completed" (typical duration ~1–2.5 min)

# 1) Job starten
curl -X POST https://www.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://www.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")

Progress: mask → inpaint → floor → completed. The job metadata carries the zone analysis (maskCoverage = edit zone/furnishable area, structureCoverage = detected interior structure (guard basis, exterior shots), protectedLabels = detected fix-zone classes, floorCoverage = share of the floor restored 1:1, floorPreserved = floor restore active) and the pixel difference outside the mask — your proof that windows & outdoor areas were left untouched. Jobs stuck without progress for more than 10 minutes are marked as failed automatically.