Worlds

Create world generation task

Creates a World Labs Marble world generation task for TokenLab-supported Marble models. Returns a task ID for polling. TokenLab supports native world_prompt media_asset references when the media asset was prepared through TokenLab.

post/v1/worlds/generations

Request

  • Base URL: https://api.tokenlab.sh
  • URL: https://api.tokenlab.sh/v1/worlds/generations
  • Auth: HTTP bearer

Headers

X-TokenLab-Delivery-Policy'auto' | 'verified' | 'official'

Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Verified first and may switch once to Official only before output, request acceptance, or persistent resource creation.

Request body

OR
OR
OR
OR
OR

Response

Task created

idstring
task_idstring
operation_idstring
status'pending' | 'processing' | 'completed' | 'failed'
poll_urlstring
world_idstring
world_marble_urlstring
model_urlstring
glb_urlstring
pano_urlstring
thumbnail_urlstring
captionstring
costobject

Changes

No recorded changes to this operation across all 1 revision of this API.