How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

World Labs Marble API

The Marble API from World Labs — 8 operation(s) for marble.

World Labs Marble API is one of 2 APIs that World Labs publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Marble. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 9 operations across 8 paths, and defines 46 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against a single base URL, https://api.worldlabs.ai.

9 operations 8 paths 46 schemas 1 DELETE3 GET5 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Server
https://api.worldlabs.ai
Authentication
API Key
Resource Areas
1

Authentication & Security 1

World Labs Marble API declares 1 security scheme for authenticating requests. An API key is passed in the header as WLT-Api-Key (ApiKeyAuth). By default, every request must be authenticated.

  • ApiKeyAuth — API key for authentication. Get your key from the developer portal.

Paths & Operations 9

Across 8 paths, the API surfaces 9 operations — 1 DELETE, 3 GET, 5 POST. Each is listed below with its method, path, parameters, and response codes.

Marble 9
GET
/marble/v1/media-assets/{media_asset_id}
Get Media Asset
get_media_asset_marble_v1_media_assets__media_asset_id__get 1 param → 200422
POST
/marble/v1/media-assets:prepare_upload
Prepare a media asset upload
prepare_media_asset_upload_marble_v1_media_assets_prepare_upload_post body → 200422
GET
/marble/v1/operations/{operation_id}
Get Operation
get_operation_marble_v1_operations__operation_id__get 1 param → 200422
POST
/marble/v1/pano:depth_to_rgb
Pano Depth To Rgb
pano_depth_to_rgb_marble_v1_pano_depth_to_rgb_post body → 200402422
DELETE
/marble/v1/worlds/{world_id}
Delete World
delete_world_marble_v1_worlds__world_id__delete 1 param → 200422
GET
/marble/v1/worlds/{world_id}
Get World
get_world_marble_v1_worlds__world_id__get 1 param → 200422
POST
/marble/v1/worlds/{world_id}:export
Export World
export_world_marble_v1_worlds__world_id__export_post 1 param body → 200402422
POST
/marble/v1/worlds:generate
Generate World
generate_world_marble_v1_worlds_generate_post body → 200402422
POST
/marble/v1/worlds:list
List Worlds
list_worlds_marble_v1_worlds_list_post body → 200422

Schemas 46

The contract defines 46 schemas that model the data the API accepts and returns. The most detailed are World (10 properties), ExportWorldResponse (9 properties), GenerateWorldResponse (9 properties), ListWorldsRequest (9 properties). Each schema is shown below with its type and property counts.

MultiImagePrompt-Input
object
Multi-image-to-world generation. Generates a world from multiple images. textprompt is optional. Recommended image formats: jpg, jpeg, png, webp.
5 properties 1 required
MediaAssetPrepareUploadRequest
object
Request to prepare a media asset upload.
4 properties 2 required
GetOperationResponse_Union_World__PanoDepthToRgbResult__ExportWorldResult__
object
9 properties 2 required
DepthPanoPrompt
object
For models conditioned on a depth pano and text. When depthpanoimage is a log-encoded PNG, zmin and zmax are required to decode it correctly. When it is an EXR…
5 properties 1 required
HTTPValidationError
object
1 property
ImagePrompt
object
Image-to-world generation. Generates a world from an image. textprompt is optional - if not provided, it will be generated via recaptioning. Recommended image…
5 properties 1 required
DataBase64Reference
object
Reference to content via base64-encoded data.
3 properties 1 required
Content
object
Represents content (media, text, images) that can be stored inline or via URL. Supports both direct data storage (up to 10MB) and URL references (up to 20MB).
3 properties
DeleteWorldResponse
object
Response from world deletion endpoint.
2 properties 2 required
WorldTextPrompt-Output
object
Input prompt class for text-conditioned world generation.
2 properties
GenerateWorldResponse
object
Response from world generation endpoint.
9 properties 2 required
OperationCost
object
Settled credit cost for a successful operation.
2 properties 1 required
WorldsGenerateRequest
object
Request to generate a world from text, image, multi-image, or video input.
6 properties 1 required
SphericallyLocatedContent-Output
object
Content with a preferred location on the sphere.
4 properties
UriReference
object
Reference to content via a publicly accessible URL.
2 properties 1 required
MediaAsset
object
A user-uploaded media asset stored in managed storage. MediaAssets can be images, videos, or binary blobs that are used as input to world generation.
7 properties 4 required
OperationCostLineItem
object
A single usage event contributing to an operation's total credits.
2 properties 2 required
PanoDepthToRgbRequest
object
Request to generate an RGB panorama from a depth panorama. Provide a depth panorama and a text prompt describing the desired appearance. The depth map supplies…
5 properties 2 required
ImageryAssets
object
Imagery asset URLs.
1 property
MultiImagePrompt-Output
object
For world models supporting multi-image (+ text) input.
4 properties 1 required
MediaAssetKind
string
High-level media asset type.
MediaAssetReference
object
Reference to a previously uploaded MediaAsset.
2 properties 1 required
ValidationError
object
3 properties 3 required
UploadUrlInfo
object
Information required to upload raw bytes directly to storage.
4 properties 2 required
VideoPrompt-Output
object
For world models supporting video (+ text) input.
3 properties 1 required
PanoDetectionMode
ListWorldsResponse
object
Response containing a list of API-generated worlds.
2 properties 1 required
ListWorldsRequest
object
Request to list API-generated worlds with optional filters.
9 properties
Operation_PanoDepthToRgbResult_
object
9 properties 2 required
PanoDepthToRgbResult
object
Result from depth-to-RGB panorama generation. Returned inside Operation.response when the operation completes successfully (done=true).
1 property
OperationError
object
Error information for a failed operation.
2 properties
SphericallyLocatedContent-Input
object
Content with a preferred location on the sphere.
2 properties 1 required
ExportWorldResponse
object
Response from world export endpoint.
9 properties 2 required
VideoPrompt-Input
object
Video-to-world generation. Generates a world from a video. textprompt is optional. Recommended video formats: mp4, webm, mov, avi. Maximum video size: 100MB.
4 properties 1 required
WorldAssets
object
Downloadable outputs of world generation.
5 properties
ExportWorldRequest
object
Request to export a generated world asset.
4 properties 2 required
World
object
A generated world, including asset URLs.
10 properties 3 required
MediaAssetPrepareUploadResponse
object
Response from preparing a media asset upload.
2 properties 2 required
InpaintPanoPrompt
object
For models that inpaint the masked portion of a pano image.
4 properties 2 required
ExportWorldResult
object
Downloadable exported world asset.
5 properties 3 required
Prompt
object
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…
4 properties 1 required
Permission
object
Access control permissions for a resource.
4 properties
WorldTextPrompt-Input
object
Text-to-world generation. Generates a world from a text description. textprompt is REQUIRED.
3 properties
SplatAssets
object
Gaussian splat asset URLs.
2 properties
WorldSemanticsMetadata
object
Semantic metadata describing how to interpret the generated splat asset in real-world units. The exported asset is in arbitrary model units. Apply the transfor…
2 properties
MeshAssets
object
Mesh asset URLs.
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

world-labs-marble-api-openapi.yml Raw ↑

Other APIs World Labs publishes across the network.

World Labs Credits API
Where this information came from

This is an independent, third-party profile of World Labs Marble API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.