Skip to main content
POST
/
marble
/
v1
/
worlds:generate
Generate World
curl --request POST \
  --url https://api.worldlabs.ai/marble/v1/worlds:generate \
  --header 'Content-Type: application/json' \
  --header 'WLT-Api-Key: <api-key>' \
  --data '
{
  "world_prompt": {
    "disable_recaption": true,
    "text_prompt": "<string>",
    "type": "text"
  },
  "display_name": "<string>",
  "model": "Marble 0.1-plus",
  "permission": {
    "allowed_readers": [],
    "allowed_writers": [],
    "public": false
  },
  "seed": 1,
  "tags": [
    "<string>"
  ]
}
'
{
  "done": true,
  "operation_id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "error": {
    "code": 123,
    "message": "<string>"
  },
  "expires_at": "2023-11-07T05:31:56Z",
  "metadata": {},
  "response": "<unknown>",
  "updated_at": "2023-11-07T05:31:56Z"
}

Authorizations

​
WLT-Api-Key
string
header
required

API key for authentication. Get your key from the developer portal.

Body

application/json

Request to generate a world from text, image, multi-image, or video input.

​
world_prompt
WorldTextPrompt · object
required

Text-to-world generation.

Generates a world from a text description. text_prompt is REQUIRED.

​
display_name
string | null

Optional display name

​
model
enum<string>
default:Marble 0.1-plus

The model to use for generation

Available options:
Marble 0.1-mini,
Marble 0.1-plus
​
permission
Permission · object

The permission for the world

​
seed
integer | null

Random seed for generation

Required range: x >= 0
​
tags
string[] | null

Optional tags for the world

Response

Successful Response

Response from world generation endpoint.

​
done
boolean
required

True if the operation is completed

​
operation_id
string
required

Operation identifier

​
created_at
string<date-time> | null

Creation timestamp

​
error
OperationError · object

Error information if the operation failed

​
expires_at
string<date-time> | null

Expiration timestamp

​
metadata
Metadata · object

Service-specific metadata, such as progress percentage

​
response
any | null

Result payload when done=true and no error. Structure depends on operation type.

​
updated_at
string<date-time> | null

Last update timestamp