Skip to main content
World generation creates explorable Marble worlds asynchronously. Use Worlds when the output is an environment users can open or revisit; use 3D generation when you need a standalone model asset.

​
Inputs And Media Assets

World tasks can start from text, images, multiple images, or video depending on the selected model and request shape. For reusable media prompts, prepare a media asset first, then reference it in the world request. Media assets and completed worlds are available only to your account.

​
Create And Poll

Create responses include a public task ID and usually a poll_url. Store that ID before showing progress, then follow poll_url or GET /v1/tasks/ until the task reaches completed or failed. 
curl -X POST "https://api.tokenlab.sh/v1/worlds/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "marble-1.1",
    "prompt": "A quiet coastal town at sunset with narrow alleys and warm lights"
  }'

​
Manage Completed Worlds

Use the Worlds list and get endpoints for completed worlds available in your account. Use task status endpoints for pending or failed generation tasks. Delete only when the user intentionally removes the generated world from your product.

​
Common Pitfalls

  • Do not assume every world model supports every input type.
  • Keep signed image or video URLs valid long enough for service fetch retries.
  • Store the returned task ID before retrying after a timeout.
  • Use 3D generation for downloadable model files rather than explorable worlds.

​
API Reference

TopicReference
Create WorldCreate World
Get World StatusGet World Status
Prepare Media Asset UploadPrepare Media Asset Upload
Get Media AssetGet Media Asset
List WorldsList Worlds
Get WorldGet World
Delete WorldDelete World
Async JobsAsync Jobs
3D Generation Guide3D Generation Guide