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"