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}

GET /v1/worlds/generations/{id} bir uyumluluk uç noktasıdır. Mevcut entegrasyonlar için desteklenmeye devam etmektedir. Yeni entegrasyonlar aynı görev id'si ile GET /v1/tasks/{id} uç noktasını sorgulamalıdır; bkz. Görev Durumunu Al.

Bu uç nokta, bir World Labs Marble oluşturma görevinin durumunu döndürür. Oluşturma yanıtından gelen görev id'sini kullanın.

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ı ve açıklamalar mevcut olduğunda döndürülür. Tamamlanmış bir görev, her varlık URL'sinin mevcut olacağını garanti etmez. Başarısız bir görev yine de HTTP 200 döndürür: status, error ve error_details alanlarını okuyun.

world_marble_url, etkileşimli World Labs görüntüleyicisini açar. glb_url, pano_url ve thumbnail_url gibi sonuç dosyaları TokenLab bağlantılarıdır; görev tamamlanana kadar boş veya eksik olabilirler.

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. 30 gün boyunca geçerli kalan bir TokenLab medya sonucu bağlantısıdır.

pano_urlstring

Mevcut olduğunda panorama görseli URL'si. 30 gün boyunca geçerli kalan bir TokenLab medya sonucu bağlantısıdır.

thumbnail_urlstring

Mevcut olduğunda küçük resim (thumbnail) URL'si. 30 gün boyunca geçerli kalan bir TokenLab medya sonucu bağlantısıdır.

captionstring

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

errorstring | object

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

error_detailsobject

Görev başarısız olduğunda hata detayları: status, message, type, code, retryable ve bir istek alanı hatalı olduğunda param.

media_retentionobject

Tamamlanmış bir yanıttaki TokenLab medya sonucu bağlantılarının saklama durumu: days ve url, kind, status ve expires_at içeren items[]. Bu alan eksik olabilir; bağlantılar yine de çalışır. Bkz. Veri saklama.

İstek

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

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