# World Labs World API (Marble) (slim)

> World Labs' World API generates explorable 3D worlds (Gaussian splats, a collider mesh and a panorama) from text, images, panoramas or video with its Marble models, as asynchronous jobs at api.worldlabs.ai paid for with prepaid credits.

- Full: https://www.anchorterminal.com/tools/world-labs.md (~7,050 tokens) · this version ~1,780 tokens · JSON https://www.anchorterminal.com/tools/world-labs.json · canonical https://www.anchorterminal.com/tools/world-labs
- Index: https://www.anchorterminal.com/llms.txt · API: https://www.anchorterminal.com/api/v1/index.json · MCP: https://www.anchorterminal.com/mcp · Updated: 2026-10-28 · pricing https://www.anchorterminal.com/tools/world-labs#pricing · reviews https://www.anchorterminal.com/tools/world-labs#reviews
- Licence: CC BY 4.0, credit Anchor Terminal and link this page (https://www.anchorterminal.com/terms/#data)

**D · 50.1/100 · rank #930 of 1221 · #2 in 3D worlds · not agent-ready · confidence medium**


Assessment: An OpenAPI 3.1 file, llms.txt and per-event credit prices make the World API straightforward to call, and a Marble 1.1 world from text costs $1.264. There is no free API tier, status page or webhook, inputs may train World Labs' models unless the user opts out, and AMD agreed in September 2026 to buy the company.

## Facts

- Kind: HTTP API · vendor: World Labs Technologies, Inc. · category: 3D worlds · legal entity: World Labs Technologies, Inc. · provenance 76/100
- Endpoint: `https://api.worldlabs.ai/marble/v1` (HTTP)
- Auth: API key · pricing: Pay per use · x402: no · licence: Proprietary service. The example and Python client repositories are MIT
- Probe metrics: not measured yet (probes haven't run)
- Surface listed: The World API (Marble Public API v1) at api.worldlabs.ai, read from the docs, llms.txt, the OpenAPI file, pricing, rate limits, errors and FAQ pages, the terms and privacy policy, and the two worldlabsai GitHub repositories on 28 October 2026. No account was made and no request sent to the API
- Models: marble-1.1-plus, marble-1.1, marble-1.0 and marble-1.0-draft. Atlas is early access for select partners and not on the API
- Inputs: Text, one image (pano detected automatically), several images with azimuths, or a video (mp4, mov, mkv). By public URL, an uploaded media asset (signed upload, up to 1 GB) or inline base64. Inline content up to 10 MB, URL content up to 20 MB per the OpenAPI file
- Outputs: SPZ splats at 100k, 500k and full resolution (about 2M splats), metric scale and ground-plane metadata, a collider mesh GLB (100k to 200k triangles), a 2560 x 1280 panorama, a caption and a thumbnail. PLY splats (free) and an HQ mesh export as textured and vertex-coloured GLB (3,500 credits, up to an hour)
- Job time: About 5 minutes per world, asynchronous. Results by polling an operation; no webhook found
- Free tier: None on the API. The Marble app's Free plan (up to 4 world generations) is a separate account and gives no API credits
- Rate limits: About 3 world-generation starts a minute and 60 an hour by default. Approved higher-throughput accounts about 30 a minute standard and 90 draft. HQ mesh generation 4 an hour per user
- Enterprise: Higher throughput on request to support. Custom Marble plans through sales. Order Forms can set other terms
- Output licence: Paid account and API users own outputs and may use them commercially. Free Marble accounts get a personal, non-commercial licence (terms of 21 January 2026)
- Training on data: The terms grant World Labs a licence to use user content to train its models. Paid users can opt out, prospectively
- SDKs and examples: No published SDK. worldlabsai/worldlabs-api-python (0.1.0, MIT, not on PyPI) and worldlabsai/worldlabs-api-examples (MIT), described as for experimentation, not production
- Ownership: AMD signed a definitive agreement on 28 September 2026 to acquire World Labs, valued at about $8.2 billion in stock, expected to close by the end of 2026
- Prices: Marble 1.1 world from text $1.264 per transaction; Marble 1.1 Plus world from text $1.264 per transaction; Marble 1.0 Draft world from text $0.184 per transaction; HQ mesh export $2.80 per transaction; API credit $0.0008 per credit

- Scores: Reliability 45, Performance pending, Schema & documentation 79, Agent ergonomics 70, Security & auth 48, Payments & pricing 20, Task success pending, Maintenance & community 10, Transparency & trust 58 · total over the 7 assessed categories
- Why: Reliability, Hosted API reading. · Schema & documentation, A public OpenAPI 3.1 file covering all ten operations (25). · Agent ergonomics, World responses are compact JSON with asset URLs, and splats come at 100k, 500k and full resolution so an agent can pick the size it downloa… · Security & auth, One kind of API key in the `WLT-Api-Key` header, created on the platform's API keys page, with more than one key per account. · Payments & pricing, No x402, MPP or L402 (0). · Maintenance & community, Closed-service reading. · Transparency & trust, Closed service with clear terms of 21 January 2026, including output ownership and commercial use for paid and API users (15).
- Sources: 22, open questions: 5, both in the full twin
- Capabilities: 3d.world-generate, 3d.reconstruct, 3d.export
- JSON: https://www.anchorterminal.com/api/v1/tools/world-labs.json
- Verify (for the vendor): the badge `https://www.anchorterminal.com/badges/world-labs.svg` or a link to https://www.anchorterminal.com/tools/world-labs from a page on worldlabs.ai or one of its subdomains, or the README of github.com/worldlabsai/worldlabs-api-python, then `POST https://www.anchorterminal.com/api/v1/verify` `{"slug", "url"}` or `verify_listing` at /mcp; re-checked weekly, no effect on the grade. Snippets in the full twin.
- Support: Discord https://discord.gg/jSSSgXWT3v; support@worldlabs.ai; https://docs.worldlabs.ai/marble/support/support-feedback; https://docs.worldlabs.ai/api/faq; https://docs.worldlabs.ai/api/errors; more in the full twin

## Before you call it

1. Send `model` explicitly, such as `marble-1.1`. Omitting it selects the legacy `marble-1.0`, and that default is due to change
2. Poll GET /marble/v1/operations/{operation_id} until `done` is true. A world takes about 5 minutes, and a non-null `error` carries `code` and `message`
3. On 429, wait for Retry-After when present and back off with jitter. A start that returned an `operation_id` was accepted, so poll it rather than resend
4. Multiply splat coordinates by `semantics_metadata.metric_scale_factor` and subtract `ground_plane_offset` from Y before measuring anything
5. Check GET /marble/v1/credits before a batch. A request can overdraw the balance, and the overage is invoiced after the month ends

## Connect

```bash
curl -X POST 'https://api.worldlabs.ai/marble/v1/worlds:generate' \
  -H 'Content-Type: application/json' \
  -H "WLT-Api-Key: $WLT_API_KEY" \
  -d '{"display_name":"Mystical Forest","model":"marble-1.1","world_prompt":{"type":"text","text_prompt":"A mystical forest with glowing mushrooms"}}'
```
Full config and headless snippets are in the full page. Through letme (picks today, calling later): https://letme.dev/world-labs

## Similar tools

| Tool | Grade | Score | Shared capabilities | Slim |
| --- | --- | --- | --- | --- |
| SpAItial API (Echo) | C | 56.7 | 3d.world-generate, 3d.export | https://www.anchorterminal.com/tools/spaitial.min.md |


## Panel reviews (0, desk reviews from public material, no calls made)