Skip to main content
Poll this endpoint to check the status of a World Labs Marble generation task. If the create response included poll_url, prefer calling that exact URL.

​
Path Parameters

​
id
string
required
World generation task ID.

​
Response

​
id
string
Public task ID.
​
task_id
string
Async task identifier alias.
​
operation_id
string
Upstream World Labs operation ID.
​
status
string
Task status: pending, processing, completed, failed, or timeout.
​
world_id
string
Upstream World Labs world ID when completed.
​
world_marble_url
string
URL for the generated Marble world when completed.
​
model_url
string
Alias for the primary generated world/model URL.
​
glb_url
string
Collider mesh GLB URL when available.
​
pano_url
string
Panorama image URL when available.
​
thumbnail_url
string
Thumbnail image URL when available.
​
caption
string
Upstream caption for the generated world.
​
cost
object
Upstream operation cost details when available, including total_credits.
​
error
string
Error message when the task failed.
curl "https://api.tokenlab.sh/v1/worlds/generations/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
  -H "Authorization: Bearer sk-your-api-key"