Worlds

Dünya Durumunu Al

Bir World Labs Marble dünya oluşturma görevinin durumunu ve sonucunu alır

GET
/v1/worlds/generations/{id}

Bir World Labs Marble oluşturma görevinin durumunu kontrol etmek için bu uç noktayı sorgulayın. Oluşturma yanıtı poll_url içeriyorsa, doğrudan o URL'yi çağırmayı tercih edin.

Süresi dolmuş veya kullanılamayan bir genel görev 404 async_task_not_found döndürebilir. Mevcut API anahtarı için görev sahipliği doğrulanamazsa, yanıt 403 task_not_owned olur.

Yol Parametreleri

idstringpathzorunlu

Dünya oluşturma görev kimliği (ID).

Yanıt

Başarılı bir durum yanıtında yalnızca id ve status zorunludur. Görev takma adları, işlem kimlikleri, dünya varlıkları, açıklamalar, maliyet ve error dizgisi mevcut olduğunda döndürülür. Tamamlanmış bir görev, her varlık URL'sinin mevcut olacağını garanti etmez.

idstring

Genel görev kimliği.

task_idstring

Asenkron görev tanımlayıcı takma adı.

operation_idstring

World Labs işlem kimliği.

statusstring

Görev durumu: pending, processing, completed, failed veya timeout.

world_idstring

Tamamlandığında World Labs dünya kimliği.

world_marble_urlstring

Tamamlandığında oluşturulan Marble dünyası için URL.

model_urlstring

Birincil oluşturulan dünya/model URL'si için takma ad.

glb_urlstring

Mevcut olduğunda çarpışma (collider) ağı GLB URL'si.

pano_urlstring

Mevcut olduğunda panorama görseli URL'si.

thumbnail_urlstring

Mevcut olduğunda küçük resim (thumbnail) URL'si.

captionstring

Oluşturulan dünya için açıklama.

costobject

total_credits dahil olmak üzere, mevcut olduğunda oluşturma maliyeti detayları. Faturalandırılan tutar için kullanım kayıtlarınızı kontrol edin.

errorstring

Görev başarısız olduğunda hata mesajı.

İstek

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"    }  }}

Yetkilendirme

BearerAuth
AuthorizationBearer <token>

API Anahtarı kimlik doğrulaması. API anahtarlarını Dashboard > API > API Keys bölümünden oluşturun veya yönetin.

Konum: header

Yol parametreleri

id*string

Dünya oluşturma görev kimliği.

Yanıt

application/json

application/json

application/json