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 Durumunu Al
World Labs Marble dünya üretim görevinin durumunu ve sonucunu alır
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"
}
}World Labs Marble üretim görevinin durumunu kontrol etmek için bu endpointi poll edin. Oluşturma yanıtı
poll_url içeriyorsa tam olarak o URLyi kullanmayı tercih edin.
Süresi dolmuş veya kullanılamayan bir görev
404 async_task_not_found döndürebilir. Geçerli API anahtarının görev sahipliği doğrulanamazsa yanıt 403 task_not_owned olur.Yol Parametreleri
string
gerekli
Dünya üretim görevi IDsi.
Yanıt
Başarılı durum yanıtında yalnızcaid ve status zorunludur. Görev takma adları, işlem ID’leri, dünya varlıkları, açıklamalar, maliyet ve metin türündeki error mevcut olduğunda döner. Tamamlanan görev, tüm varlık URL’lerinin bulunduğunu garanti etmez.
string
Genel görev IDsi.
string
Asenkron görev tanımlayıcı aliası.
string
World Labs işlem kimliği.
string
Görev durumu:
pending, processing, completed, failed veya timeout.string
Tamamlandığında World Labs dünya kimliği.
string
Tamamlandığında oluşturulan Marble dünya URLsi.
string
Birincil oluşturulan dünya/model URLsi için alias.
string
Varsa collider mesh GLB URLsi.
string
Varsa panorama görüntü URLsi.
string
Varsa thumbnail görüntü URLsi.
string
Oluşturulan dünya için upstream caption.
object
Varsa
total_credits dahil üretim maliyet bilgileri. Faturalanan tutar için kullanım kayıtlarına bakın.string
Görev başarısız olduğunda hata mesajı.
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);
Yetkilendirmeler
API Anahtarı kimlik doğrulaması. API anahtarlarını Dashboard > API > API Keys bölümünden oluşturun veya yönetin.
Yol Parametreleri
Dünya oluşturma görev kimliği.