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.