TokenLab
Get API key
DocumentationAPI ReferenceIntegrations

Worlds

Get World Status

Retrieves the status and result of a World Labs Marble world generation task

GET
/v1/worlds/generations/{id}

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.

An expired or unavailable public task can return 404 async_task_not_found. If task ownership cannot be established for the current API key, the response is 403 task_not_owned.

Path Parameters

idstringpathrequired

World generation task ID.

Response

Only id and status are required in a successful status response. Task aliases, operation IDs, world assets, captions, cost, and the string error are returned when available. A completed task does not guarantee that every asset URL is present.

idstring

Public task ID.

task_idstring

Async task identifier alias.

operation_idstring

World Labs operation ID.

statusstring

Task status: pending, processing, completed, failed, or timeout.

world_idstring

World Labs world ID when completed.

world_marble_urlstring

URL for the generated Marble world when completed.

model_urlstring

Alias for the primary generated world/model URL.

glb_urlstring

Collider mesh GLB URL when available.

pano_urlstring

Panorama image URL when available.

thumbnail_urlstring

Thumbnail image URL when available.

captionstring

Caption for the generated world.

costobject

Generation cost details when available, including total_credits. Check your usage records for the billed amount.

errorstring

Error message when the task failed.

Request

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

Authorization

BearerAuth
AuthorizationBearer <token>

API Key authentication. Create or manage API keys in Dashboard > API > API Keys.

In: header

Path Parameters

id*string

World generation task ID.

Response

application/json

application/json

application/json

Create World

Previous

List Worlds

Next