Worlds

Weltstatus abrufen

Ruft den Status und das Ergebnis einer World Labs Marble Weltgenerierungsaufgabe ab

GET
/v1/worlds/generations/{id}

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

idstringpatherforderlich

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.

idstring

Öffentliche Aufgaben-ID.

task_idstring

Alias für die asynchrone Aufgabenkennung.

operation_idstring

World Labs Operations-ID.

statusstring

Aufgabenstatus: pending, processing, completed, failed oder timeout.

world_idstring

World Labs Welt-ID nach Abschluss.

world_marble_urlstring

URL für die generierte Marble-Welt nach Abschluss.

model_urlstring

Alias für die primäre URL der generierten Welt/des Modells.

glb_urlstring

URL des Collider-Mesh-GLB, sofern verfügbar. Ein TokenLab-Medien-Ergebnis-Link, der 30 Tage lang gültig bleibt.

pano_urlstring

URL des Panoramabildes, sofern verfügbar. Ein TokenLab-Medien-Ergebnis-Link, der 30 Tage lang gültig bleibt.

thumbnail_urlstring

URL des Vorschaubildes, sofern verfügbar. Ein TokenLab-Medien-Ergebnis-Link, der 30 Tage lang gültig bleibt.

captionstring

Bildunterschrift für die generierte Welt.

errorstring | object

Fehlermeldung, wenn die Aufgabe fehlgeschlagen ist.

error_detailsobject

Fehlerdetails, wenn die Aufgabe fehlgeschlagen ist: status, message, type, code, retryable und param, wenn ein Anforderungsfeld fehlerhaft ist.

media_retentionobject

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
AuthorizationBearer <token>

API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.

Ort: header

Pfadparameter

id*string

Aufgaben-ID der World-Generation.

Antwort

application/json

application/json

application/json