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 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
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.
Genel görev kimliği.
Asenkron görev tanımlayıcı takma adı.
World Labs işlem kimliği.
Görev durumu: pending, processing, completed, failed veya timeout.
Tamamlandığında World Labs dünya kimliği.
Tamamlandığında oluşturulan Marble dünyası için URL.
Birincil oluşturulan dünya/model URL'si için takma ad.
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.
Mevcut olduğunda panorama görseli URL'si. 30 gün boyunca geçerli kalan bir TokenLab medya sonucu bağlantısıdır.
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.
Oluşturulan dünya için açıklama.
Görev başarısız olduğunda hata mesajı.
Görev başarısız olduğunda hata detayları: status, message, type, code, retryable ve bir istek alanı hatalı olduğunda param.
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 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
Dünya oluşturma görev kimliği.
Yanıt
application/json
application/json
application/json