Worlds
Weltstatus abrufen
Ruft den Status und das Ergebnis einer World Labs Marble Weltgenerierungsaufgabe ab
GET /v1/worlds/generations/{id} ist ein Kompatibilitäts-Endpunkt. Er wird für bestehende Integrationen weiterhin unterstützt. Neue Integrationen sollten GET /v1/tasks/{id} mit derselben Aufgaben-id abfragen; siehe Aufgabenstatus abrufen.
Dieser Endpunkt gibt den Status einer World Labs Marble Generierungsaufgabe zurück. Verwenden Sie die Aufgaben-id aus der Erstellungsantwort.
Eine abgelaufene oder nicht verfügbare öffentliche Aufgabe kann 404 async_task_not_found zurückgeben. Wenn die Aufgabeninhaberschaft für den aktuellen API-Schlüssel nicht festgestellt werden kann, lautet die Antwort 403 task_not_owned.
Pfadparameter
ID der Weltgenerierungsaufgabe.
Antwort
Nur id und status sind in einer erfolgreichen Statusantwort erforderlich. Aufgaben-Aliase, Operations-IDs, Welt-Assets und Bildunterschriften werden zurückgegeben, sofern verfügbar. Eine abgeschlossene Aufgabe garantiert nicht, dass jede Asset-URL vorhanden ist. Eine fehlgeschlagene Aufgabe gibt dennoch HTTP 200 zurück: Lesen Sie status, error und error_details.
world_marble_url öffnet den interaktiven World Labs Viewer. Ergebnisdateien wie glb_url, pano_url und thumbnail_url sind TokenLab-Links; sie sind leer oder nicht vorhanden, bis die Aufgabe abgeschlossen ist.
Öffentliche Aufgaben-ID.
Alias für die asynchrone Aufgabenkennung.
World Labs Operations-ID.
Aufgabenstatus: pending, processing, completed, failed oder timeout.
World Labs Welt-ID nach Abschluss.
URL für die generierte Marble-Welt nach Abschluss.
Alias für die primäre URL der generierten Welt/des Modells.
URL des Collider-Mesh-GLB, sofern verfügbar. Ein TokenLab-Medien-Ergebnis-Link, der 30 Tage lang gültig bleibt.
URL des Panoramabildes, sofern verfügbar. Ein TokenLab-Medien-Ergebnis-Link, der 30 Tage lang gültig bleibt.
URL des Vorschaubildes, sofern verfügbar. Ein TokenLab-Medien-Ergebnis-Link, der 30 Tage lang gültig bleibt.
Bildunterschrift für die generierte Welt.
Fehlermeldung, wenn die Aufgabe fehlgeschlagen ist.
Fehlerdetails, wenn die Aufgabe fehlgeschlagen ist: status, message, type, code, retryable und param, wenn ein Anforderungsfeld fehlerhaft ist.
Speicherstatus der TokenLab-Medien-Ergebnis-Links in einer abgeschlossenen Antwort: days und items[] mit url, kind, status und expires_at. Kann fehlen; die Links funktionieren weiterhin. Siehe Datenaufbewahrung.
Anfrage
curl --fail-with-body "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
-H "Authorization: Bearer sk-your-api-key"{ "id": "string", "task_id": "string", "operation_id": "string", "status": "pending", "world_id": "string", "world_marble_url": "string", "model_url": "string", "glb_url": "string", "pano_url": "string", "thumbnail_url": "string", "caption": "string", "error": "string", "error_details": { "projection_version": 0, "status": 400, "message": "string", "type": "string", "code": "string", "param": "string", "retryable": true, "upstream": { "source": "string", "code": "string", "message": "string", "param": "string" } }, "media_retention": { "days": 0, "items": [ { "url": "http://example.com", "kind": "image", "content_type": "string", "status": "saving", "expires_at": "2019-08-24T14:15:22Z" } ] }}Autorisierung
BearerAuth API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.
Ort: header
Pfadparameter
Aufgaben-ID der World-Generation.
Antwort
application/json
application/json
application/json