Worlds
Weltstatus abrufen
Ruft den Status und das Ergebnis einer World Labs Marble Weltgenerierungsaufgabe ab
Fragen Sie diesen Endpunkt ab, um den Status einer World Labs Marble Generierungsaufgabe zu überprüfen. Wenn die Erstellungsantwort eine poll_url enthielt, bevorzugen Sie den Aufruf dieser exakten URL.
Eine abgelaufene oder nicht verfügbare öffentliche Aufgabe kann 404 async_task_not_found zurückgeben. Wenn die Aufgabeninhaberschaft für den aktuellen API-Key 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, Bildunterschriften, Kosten und der String error werden zurückgegeben, sofern verfügbar. Eine abgeschlossene Aufgabe garantiert nicht, dass jede Asset-URL vorhanden 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.
URL des Panorama-Bildes, sofern verfügbar.
URL des Vorschaubildes, sofern verfügbar.
Bildunterschrift für die generierte Welt.
Details zu den Generierungskosten, sofern verfügbar, einschließlich total_credits. Überprüfen Sie Ihre Nutzungsdatensätze für den abgerechneten Betrag.
Fehlermeldung, wenn die Aufgabe fehlgeschlagen ist.
Anfrage
curl --fail-with-body "https://api.tokenlab.sh/v1/worlds/generations/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", "cost": {}, "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" } }}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