Skip to main content
Generate explorable 3D worlds with World Labs Marble. This is an asynchronous API: create responses return a task identity and a poll_url for status checks. Supported models are marble-1.0, marble-1.1, and marble-1.1-plus. World Labs documents marble-1.0-draft, but TokenLab does not expose draft generation in this endpoint yet.

​
Request Body

​
model
string
default:"marble-1.0"
Marble model to use: marble-1.0, marble-1.1, or marble-1.1-plus.
​
prompt
string
Text prompt for text-only generation or as guidance with image/video inputs.
​
world_prompt
object
Native World Labs world_prompt object for advanced callers. Supported prompt types are text, image, multi-image, and video.
​
image
string
Base64 or data URL image prompt.
​
image_url
string
Image URL prompt.
​
images
array
Multiple image prompts for shortcut multi-image generation. Provide up to 4 images. For native World Labs reconstruction mode, pass world_prompt.type="multi-image" with reconstruct_images: true and up to 8 images.
​
video_url
string
Video URL prompt.
​
is_pano
boolean | string
For image inputs, set true for an existing panorama, false for a normal single image, or auto.
​
seed
integer
Optional seed from 0 through 4294967295.
​
display_name
string
Optional display name for the upstream world, up to 64 characters.
​
tags
array
Optional upstream tags. Provide up to 10 tags, each up to 32 characters.
​
permission
object
Optional World Labs permission object.

​
Response

​
id
string
Public task ID for polling.
​
task_id
string
Async task identifier alias.
​
operation_id
string
Upstream World Labs operation ID.
​
poll_url
string
Preferred polling URL for this task.
​
status
string
Task status: pending, processing, completed, or failed.
​
world_marble_url
string
URL for the generated Marble world when completed.
​
glb_url
string
Collider mesh GLB URL when available.
​
pano_url
string
Panorama image URL when available.

​
Pricing

World Labs bills in credits. TokenLab pre-deducts the request-type maximum and settles from the completed operation’s cost.total_credits when available. Standard Marble requests are up to 1,600 credits. marble-1.1-plus requests are up to 3,100 credits.

​
Scope

These management endpoints cover TokenLab-owned media assets and completed generated worlds. TokenLab still does not expose marble-1.0-draft generation or standalone pano/depth tools. 
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"
  }'