Worlds
Mendapatkan Status Dunia
Mengambil status dan hasil dari tugas pembuatan dunia World Labs Marble
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
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.
ID tugas publik.
Alias pengenal tugas asinkron.
ID operasi World Labs.
Status tugas: pending, processing, completed, failed, atau timeout.
ID dunia World Labs saat selesai.
URL untuk dunia Marble yang dihasilkan saat selesai.
Alias untuk URL dunia/model utama yang dihasilkan.
URL GLB mesh collider saat tersedia. Tautan hasil media TokenLab yang tetap valid selama 30 hari.
URL gambar panorama saat tersedia. Tautan hasil media TokenLab yang tetap valid selama 30 hari.
URL gambar thumbnail saat tersedia. Tautan hasil media TokenLab yang tetap valid selama 30 hari.
Keterangan untuk dunia yang dihasilkan.
Pesan kesalahan saat tugas gagal.
Detail kegagalan saat tugas gagal: status, message, type, code, retryable, dan param jika terjadi kesalahan pada field permintaan.
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 Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.
Lokasi: header
Parameter path
ID tugas pembuatan dunia.
Respons
application/json
application/json
application/json