Worlds

Dapatkan Status Dunia

Mengambil status dan hasil dari tugas pembuatan dunia World Labs Marble

GET
/v1/worlds/generations/{id}

Lakukan polling pada endpoint ini untuk memeriksa status tugas pembuatan World Labs Marble. Jika respons pembuatan menyertakan poll_url, lebih baik panggil URL yang tepat tersebut.

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 wajib ada dalam respons status yang berhasil. Alias tugas, ID operasi, aset dunia, keterangan, biaya, dan string error akan dikembalikan jika tersedia. Tugas yang selesai tidak menjamin bahwa setiap URL aset tersedia.

idstring

ID tugas publik.

task_idstring

Alias pengidentifikasi 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 jika tersedia.

pano_urlstring

URL gambar panorama jika tersedia.

thumbnail_urlstring

URL gambar thumbnail jika tersedia.

captionstring

Keterangan untuk dunia yang dihasilkan.

costobject

Detail biaya pembuatan jika tersedia, termasuk total_credits. Periksa catatan penggunaan Anda untuk jumlah yang ditagihkan.

errorstring

Pesan kesalahan saat tugas gagal.

Permintaan

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

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