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 AI Sonar does not expose draft generation in this endpoint yet.

Request Body

string
default:"marble-1.0"
Marble model to use: marble-1.0, marble-1.1, or marble-1.1-plus.
string
Text prompt for text-only generation or as guidance with image/video inputs.
object
Native World Labs world_prompt object for advanced callers. Supported prompt types are text, image, multi-image, and video.
string
Base64 or data URL image prompt.
string
Image URL prompt.
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.
string
Video URL prompt.
boolean | string
For image inputs, set true for an existing panorama, false for a normal single image, or auto.
integer
Optional seed from 0 through 4294967295.
string
Optional display name for the generated world, up to 64 characters.
array
Optional World Labs tags. Provide up to 10 tags, each up to 32 characters.
object
Optional World Labs permission object.

Response

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

Pricing

World Labs bills in credits. AI Sonar 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 AI Sonar-owned media assets and completed generated worlds. AI Sonar still does not expose marble-1.0-draft generation or standalone pano/depth tools.