Splats per Schnittstelle bestellen

1. 1

   Anlegen

   POST /api/v1/captures mit Dateiname und Größe, optional Standort, Name, eigener Referenz (clientRef), Qualität und Ablauf. Die Antwort enthält presignte Teile für den Upload.

2. 2

   Direkt in den Bucket hochladen

   Jeder Teil geht per PUT an seine presignte URL — an uns vorbei. Die Steuerungsebene sieht die Bytes nie; sie erfährt nur, dass sie angekommen sind.

3. 3

   Abschließen

   POST /api/v1/captures/:id/complete mit den ETags der Teile. Ab hier läuft es von selbst: Vorab-Check, Start, Prüfschritte, Training, Kollisionsmesh, Paket.

4. 4

   Verfolgen und abholen

   GET /api/v1/captures/:id pollen, bis der Zustand done ist — oder einen Webhook registrieren. Das Paket liefert GET /api/v1/captures/:id/result.

curl -X POST https://splatastic.com/api/v1/captures \
  -H "Authorization: Bearer sk_…" -H "Content-Type: application/json" \
  -d '{
    "filename": "rundgang.mp4",
    "sizeBytes": 214748364,
    "siteName": "Halle 12",
    "clientRef": "acme:asset-42",
    "quality": "standard",
    "flow": "headless"
  }'

{
  "id": "cap_…",
  "siteId": "site_…",
  "clientRef": "acme:asset-42",
  "state": "uploading",
  "upload": {
    "uploadId": "up_…",
    "key": "captures/cap_…/sources/….mp4",
    "partSize": 16777216,
    "partCount": 13,
    "parts": [{ "partNumber": 1, "url": "https://…" }, "…"]
  }
}

curl -X POST https://splatastic.com/api/v1/captures/cap_…/complete \
  -H "Authorization: Bearer sk_…" -H "Content-Type: application/json" \
  -d '{
    "uploadId": "up_…",
    "parts": [{ "partNumber": 1, "etag": "\"…\"" }, "…"]
  }'

{
  "id": "cap_…", "name": "Halle 12", "siteId": "site_…",
  "clientRef": "acme:asset-42", "flow": "headless",
  "state": "processing",
  "stage": "training",
  "progress": 0.62,
  "etaSeconds": 480,
  "needsReview": null,
  "error": null,
  "hasResult": false,
  "createdAt": 1757500000000,
  "updatedAt": 1757500600000
}

unattended ist für ein System gedacht, das das Ergebnis ohnehin selbst prüft und nur Splat und Kollisionsnetz will: Es tauscht die Ampel gegen Durchsatz. Ein Lauf, dessen Kamerabahn rot war, liefert trotzdem — und ist an seinen Messwerten als solcher zu erkennen.

{
  "deliveryId": "del_…",
  "builtAt": 1757500600000,
  "expiresAt": 1757504200000,
  "files": {
    "splatPly":     { "url": "https://…", "filename": "splat.ply",     "sizeBytes": 214748364 },
    "collisionGlb": { "url": "https://…", "filename": "collision.glb", "sizeBytes": 5242880 },
    "metaJson":     { "url": "https://…", "filename": "meta.json",     "sizeBytes": 512 },
    "packageZip":   { "url": "https://…", "filename": "package.zip",   "sizeBytes": 225000000 }
  },
  "meta": { "version": 1, "metersPerUnit": 1, "upAxis": "Y", "…": "…" },
  "metrics": { "psnr": 27.3, "splatCount": 812000, "…": "…" }
}

Dazu trägt meta.json alles, was sonst noch bekannt ist: Herkunft, Qualitätsstufe, Kennzahlen des Laufs und unter areaCrop die Stufe, mit der die gelieferte Fassung auf den erfassten Bereich beschnitten wurde. Seit dem 17.09.2026 ist generous die Vorgabe— wer die volle Szene will, schickt beim Anlegen ausdrücklich "areaCrop": "off" mit. Was tatsächlich angewandt wurde, steht in jedem Paket in meta.json; das ist die verlässliche Angabe.

Die URLs aus …/result sind Abholscheine und laufen nach einer Stunde ab: Ein dauerhaft gültiger Link wäre ein Passwort, das nie abläuft. Kopier dir die Bytes; ein erneuter Aufruf liefert jederzeit frische URLs.