GET

/v1/schemas/worldlabs/world/marble/v1/worlds/{world_id}?kind=output

Accept:

kind outputactivity worldhash 96bd91c1…extracted Nov 10, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. upstream-spec Source trace `4a3ed614672e0b640de378db458907865a4e9c05499482f1e2a79fba5977eebe` { "fetchedAt": 1794287457, "extractorVersion": "2", "verifiedAt": null }

Response body

10 properties · 3 required · 14 $defs

property	type	description	constraints
display_name*	string	Display name
world_id*	string	World identifier
world_marble_url*	string	World Marble URL
assets	WorldAssets	Downloadable outputs of world generation.	nullable
created_at	string	Creation timestamp	format: date-time · nullable
model	string	Model used for generation	nullable
permission	Permission	Access control permissions for a resource.	nullable
tags	string[]	Tags associated with the world	nullable
updated_at	string	Last update timestamp	format: date-time · nullable
world_prompt	WorldTextPrompt \| Prompt \| MultiImagePrompt \| …	World prompt	nullable

Types

14 $defs

Contentobject

Represents content (media, text, images) that can be stored inline or via URL.

data_base64	string		nullable
extension	string	File extension without dot	nullable
uri	string		nullable

For models conditioned on a depth pano and text. When depth_pano_image is a log-encoded PNG, z_min and z_max are required to decode it correctly. When it is an EXR file containing raw float depth values, z_min and z_max will both be ignored. Please set z_min a…

depth_pano_image*	Content	Represents content (media, text, images) that can be stored inline or via URL.
text_prompt	string		nullable
type	const		"depth-pano" · default: "depth-pano"
z_max	number		nullable
z_min	number		nullable

ImageryAssetsobject

Imagery asset URLs.

pano_url

string

Panorama image URL

nullable

InpaintPanoPromptobject

For models that inpaint the masked portion of a pano image.

pano_image*	Content	Represents content (media, text, images) that can be stored inline or via URL.
pano_mask*	Content	Represents content (media, text, images) that can be stored inline or via URL.
text_prompt	string		nullable
type	const		"inpaint-pano" · default: "inpaint-pano"

MeshAssetsobject

Mesh asset URLs.

collider_mesh_url	string	Collider mesh URL	nullable
full_res_mesh_url	string	Full-resolution vertex-colored mesh URL	nullable
hq_mesh_url	string	High-quality textured mesh URL	nullable

MultiImagePrompt-Outputobject

For world models supporting multi-image (+ text) input.

multi_image_prompt*	SphericallyLocatedContent-Output[]
reconstruct_images	boolean	default: false
text_prompt	string	nullable
type	const	"multi-image" · default: "multi-image"

Permissionobject

Access control permissions for a resource.

allow_id_access	boolean	default: false
allowed_readers	string[]
allowed_writers	string[]
public	boolean	default: false

Promptobject

For world models generating a world from a single image (+ text). Images can be generated using the :image-generation method. If no text prompt is provided, it will be generated via recaption.

image_prompt*	Content	Represents content (media, text, images) that can be stored inline or via URL.
is_pano	boolean		default: false
text_prompt	string		nullable
type	const		"image" · default: "image"

SphericallyLocatedContent-Outputobject

Content with a preferred location on the sphere.

azimuth	number		nullable
data_base64	string		nullable
extension	string	File extension without dot	nullable
uri	string		nullable

SplatAssetsobject

Gaussian splat asset URLs.

semantics_metadata	WorldSemanticsMetadata	Semantic metadata describing how to interpret the generated splat asset in real-world units.	nullable
spz_urls	object	URLs for SPZ format Gaussian splat files	nullable

VideoPrompt-Outputobject

For world models supporting video (+ text) input.

text_prompt	string		nullable
type	const		"video" · default: "video"
video_prompt*	Content	Represents content (media, text, images) that can be stored inline or via URL.

WorldAssetsobject

Downloadable outputs of world generation.

caption	string	AI-generated description of the world	nullable
imagery	ImageryAssets	Imagery asset URLs.	nullable
mesh	MeshAssets	Mesh asset URLs.	nullable
splats	SplatAssets	Gaussian splat asset URLs.	nullable
thumbnail_url	string	Thumbnail URL for the world	nullable

WorldSemanticsMetadataobject

Semantic metadata describing how to interpret the generated splat asset in real-world units.

ground_plane_offset	number	Vertical (Y-axis) offset, in meters, of the detected ground plane in the metric-scaled frame. Subtract from Y after applying `metric_scale_factor` to place the ground at y=0.	nullable
metric_scale_factor	number	Multiplicative factor that converts raw asset coordinates to meters. Multiply all XYZ positions (and isotropic scales) by this value. A value of 1.0 means scale could not be inferred and the asset was left in model units.	nullable

WorldTextPrompt-Outputobject

Input prompt class for text-conditioned world generation.

text_prompt	string		nullable
type	const		"text" · default: "text"

Validate a payload

before you spend tokens

shell

$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"worldlabs","endpointId":"marble/v1/worlds/{world_id}","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}