curl --fail-with-body "https://api.tokenlab.sh/v1/worlds/generations/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
-H "Authorization: Bearer sk-your-api-key"
import requests
import time
task_id = "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
while True:
response = requests.get(
f"https://api.tokenlab.sh/v1/worlds/generations/{task_id}",
headers={"Authorization": "Bearer sk-your-api-key"},
)
response.raise_for_status()
result = response.json()
if result["status"] in ["completed", "failed", "timeout"]:
print(result)
break
time.sleep(10)
const taskId = 'ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa';
const response = await fetch(`https://api.tokenlab.sh/v1/worlds/generations/${taskId}`, {
headers: { Authorization: 'Bearer sk-your-api-key' }
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);
{
"id": "<string>",
"status": "pending",
"task_id": "<string>",
"operation_id": "<string>",
"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": {
"message": "Invalid API key provided",
"type": "invalid_api_key"
}
}{
"error": {
"message": "API key not found",
"type": "invalid_request_error"
}
}Worlds
World-Status abrufen
Ruft Status und Ergebnis einer World Labs Marble-Weltgenerierungsaufgabe ab
GET
/
v1
/
worlds
/
generations
/
{id}
curl --fail-with-body "https://api.tokenlab.sh/v1/worlds/generations/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
-H "Authorization: Bearer sk-your-api-key"
import requests
import time
task_id = "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
while True:
response = requests.get(
f"https://api.tokenlab.sh/v1/worlds/generations/{task_id}",
headers={"Authorization": "Bearer sk-your-api-key"},
)
response.raise_for_status()
result = response.json()
if result["status"] in ["completed", "failed", "timeout"]:
print(result)
break
time.sleep(10)
const taskId = 'ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa';
const response = await fetch(`https://api.tokenlab.sh/v1/worlds/generations/${taskId}`, {
headers: { Authorization: 'Bearer sk-your-api-key' }
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);
{
"id": "<string>",
"status": "pending",
"task_id": "<string>",
"operation_id": "<string>",
"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": {
"message": "Invalid API key provided",
"type": "invalid_api_key"
}
}{
"error": {
"message": "API key not found",
"type": "invalid_request_error"
}
}Pollen Sie diesen Endpoint, um den Status einer World Labs Marble-Generierungsaufgabe zu prüfen. Wenn die Create-Response
poll_url enthält, verwenden Sie bevorzugt genau diese URL.
Ein abgelaufener oder nicht verfügbarer öffentlicher Task kann
404 async_task_not_found zurückgeben. Ist die Zugehörigkeit zum aktuellen API-Schlüssel nicht feststellbar, lautet die Antwort 403 task_not_owned.Pfadparameter
string
erforderlich
Weltgenerierungs-Task-ID.
Antwort
In einer erfolgreichen Statusantwort sind nurid und status erforderlich. Aufgaben-Aliase, Operations-IDs, Weltressourcen, Beschreibungen, Kosten und der String error werden bei Verfügbarkeit zurückgegeben. Ein abgeschlossener Auftrag enthält nicht unbedingt jede Ressourcen-URL.
string
Öffentliche Task-ID.
string
Alias für die Async-Task-ID.
string
World-Labs-Vorgangs-ID.
string
Task-Status:
pending, processing, completed, failed oder timeout.string
World-Labs-Welt-ID nach Abschluss.
string
URL der generierten Marble-Welt nach Abschluss.
string
Alias für die primäre generierte Welt-/Modell-URL.
string
Collider-Mesh-GLB-URL, sofern verfügbar.
string
Panorama-Bild-URL, sofern verfügbar.
string
Thumbnail-Bild-URL, sofern verfügbar.
string
Upstream-caption für die generierte Welt.
object
Generierungskosten, sofern vorhanden, einschließlich
total_credits. Den Rechnungsbetrag finden Sie in Ihren Nutzungsdaten.string
Fehlermeldung bei fehlgeschlagenem Task.
curl --fail-with-body "https://api.tokenlab.sh/v1/worlds/generations/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
-H "Authorization: Bearer sk-your-api-key"
import requests
import time
task_id = "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
while True:
response = requests.get(
f"https://api.tokenlab.sh/v1/worlds/generations/{task_id}",
headers={"Authorization": "Bearer sk-your-api-key"},
)
response.raise_for_status()
result = response.json()
if result["status"] in ["completed", "failed", "timeout"]:
print(result)
break
time.sleep(10)
const taskId = 'ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa';
const response = await fetch(`https://api.tokenlab.sh/v1/worlds/generations/${taskId}`, {
headers: { Authorization: 'Bearer sk-your-api-key' }
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);
Autorisierungen
API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.
Pfadparameter
Aufgaben-ID der World-Generation.
Antwort
Aufgabenstatus