Worlds

Mendapatkan Status Dunia

Mengambil status dan hasil dari tugas pembuatan dunia World Labs Marble

GET
/v1/worlds/generations/{id}

GET /v1/worlds/generations/{id} adalah endpoint kompatibilitas. Endpoint ini tetap didukung untuk integrasi yang sudah ada. Integrasi baru harus melakukan polling ke GET /v1/tasks/{id} dengan id tugas yang sama; lihat Mendapatkan Status Tugas.

Endpoint ini mengembalikan status tugas pembuatan World Labs Marble. Gunakan id tugas dari respons pembuatan.

Tugas publik yang kedaluwarsa atau tidak tersedia dapat mengembalikan 404 async_task_not_found. Jika kepemilikan tugas tidak dapat dipastikan untuk API key saat ini, responsnya adalah 403 task_not_owned.

Parameter Path

idstringpathwajib

ID tugas pembuatan dunia.

Respons

Hanya id dan status yang diperlukan dalam respons status yang berhasil. Alias tugas, ID operasi, aset dunia, dan keterangan (caption) akan dikembalikan jika tersedia. Tugas yang selesai tidak menjamin bahwa setiap URL aset akan ada. Tugas yang gagal tetap mengembalikan HTTP 200: baca status, error, dan error_details.

world_marble_url membuka penampil World Labs interaktif. File hasil seperti glb_url, pano_url, dan thumbnail_url adalah tautan TokenLab; tautan tersebut kosong atau tidak ada sampai tugas selesai.

idstring

ID tugas publik.

task_idstring

Alias pengenal tugas asinkron.

operation_idstring

ID operasi World Labs.

statusstring

Status tugas: pending, processing, completed, failed, atau timeout.

world_idstring

ID dunia World Labs saat selesai.

world_marble_urlstring

URL untuk dunia Marble yang dihasilkan saat selesai.

model_urlstring

Alias untuk URL dunia/model utama yang dihasilkan.

glb_urlstring

URL GLB mesh collider saat tersedia. Tautan hasil media TokenLab yang tetap valid selama 30 hari.

pano_urlstring

URL gambar panorama saat tersedia. Tautan hasil media TokenLab yang tetap valid selama 30 hari.

thumbnail_urlstring

URL gambar thumbnail saat tersedia. Tautan hasil media TokenLab yang tetap valid selama 30 hari.

captionstring

Keterangan untuk dunia yang dihasilkan.

errorstring | object

Pesan kesalahan saat tugas gagal.

error_detailsobject

Detail kegagalan saat tugas gagal: status, message, type, code, retryable, dan param jika terjadi kesalahan pada field permintaan.

media_retentionobject

Status penyimpanan tautan hasil media TokenLab dalam respons yang selesai: days dan items[] dengan url, kind, status, dan expires_at. Field ini bisa saja tidak ada; tautan tetap berfungsi. Lihat Retensi data.

Permintaan

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

Otorisasi

BearerAuth
AuthorizationBearer <token>

Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.

Lokasi: header

Parameter path

id*string

ID tugas pembuatan dunia.

Respons

application/json

application/json

application/json