marble-developer-api

World Labs API

Use this skill when the user is working with the published World Labs / Marble Public API v1.

Before answering API-contract questions or writing integration code, read references/api.md. For exact current endpoint and schema details, also inspect references/openapi.yaml.

Working Style

• Authenticate with the WLT-Api-Key header, not bearer auth.
• Treat API keys as secrets. Never print, commit, or log a real key.
• Prefer explicit model names such as marble-1.1 or marble-1.1-plus.
• Use media asset uploads for local image/video files before world generation.
• Poll /marble/v1/operations/{operation_id} until done is true; fetch the world by world_id when the caller needs the latest world object.
• Verify against references/openapi.yaml when generating clients or naming request fields.

Common Tasks

• Write curl, Python, TypeScript, or SDK-style examples for world generation, operation polling, world retrieval, media asset upload, and pano depth-to-RGB.
• Generate or update client code from the OpenAPI spec.
• Explain request shapes for text, image, multi-image, video, media-asset, and URL-based world prompts.
• Debug authentication, validation, media upload, operation status, and asset URL issues.