Atlas World Model API Guide

How to call the World Labs Atlas API: API keys, request examples, rate limits and credit costs for integrating world generation into your app.

Updated 2026-11-14 · Independent guide, not affiliated with World Labs

The Atlas Developer API lets your own app run the same world-building steps as the Atlas web app: pose images, generate new views, edit scenes, reconstruct Gaussian splats and convert them to meshes. Every task is asynchronous. You submit a task, get an operation back, and poll it until done is true. This guide covers setup, a working curl flow, limits and pricing as of November 2026.

Setup

  1. Open Developers in the Atlas platform, select API keys, and create a key. Keys are scoped to a project, so assets, operations, usage and spend limits stay separate per project.
  2. Give the key the scopes it needs: tasks.create, operations.read, assets.create and assets.read (plus assets.delete if you delete assets).
  3. Copy the secret when it appears. It cannot be shown again. Keep it server-side.

Base URL and auth:

ItemValue
Base URLhttps://api.atlas.worldlabs.ai/api/v2
Auth headerWLT-Api-Key: your_key
Health checkGET /health (no key needed)
IdempotencyOptional Idempotency-Key header, up to 128 characters

World Labs also ships a CLI (@worldlabsai/cli, Node.js 22 or newer), a TypeScript client (@worldlabsai/client), agent skills, and a hosted MCP server at https://api.atlas.worldlabs.ai/mcp that uses your sign-in instead of an API key.

The tasks

TaskUse it to
atlasTextToImageMake a starting image from a text description
images2PosedRGBDEstimate camera pose and depth for your images
atlasGenerateRender new views of a scene at target cameras (frames, not video)
atlasChiselRender a layout from depth, restyle a scene, or edit masked regions
posedImages2SplatsReconstruct a Gaussian splat (SPZ) from 2 to 512 posed frames
splats2MeshConvert an SPZ splat into a GLB mesh

Tasks are submitted with POST /tasks:taskName. A typical pipeline is images2PosedRGBD, then atlasGenerate, then posedImages2Splats, then optionally splats2Mesh.

Example: asset, task, operation

1. Configure and check connectivity

export WLT_API_BASE_URL="https://api.atlas.worldlabs.ai/api/v2"
export WLT_API_KEY="your_key_here"

curl --fail-with-body --silent --show-error "$WLT_API_BASE_URL/health"

2. Create an asset from a public URL

The platform fetches the URL once and stores its own copy. You can also send inline base64 (smaller than 10 MiB) or use the upload flow for files up to 1 GiB.

curl --fail-with-body --silent --show-error \
  --request POST "$WLT_API_BASE_URL/assets" \
  --header "WLT-Api-Key: $WLT_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "asset": {
      "displayName": "room.jpg",
      "url": "https://example.com/room.jpg"
    }
  }' > asset.json

ASSET_ID=$(jq -er '.id' asset.json)

3. Submit a task

This poses the image and estimates depth. targetResolution accepts 1280x720, 720x1280, 960x720 or 528x704.

curl --fail-with-body --silent --show-error \
  --request POST "$WLT_API_BASE_URL/tasks:images2PosedRGBD" \
  --header "WLT-Api-Key: $WLT_API_KEY" \
  --header "Idempotency-Key: pose-room-001" \
  --header "Content-Type: application/json" \
  --data "{
    \"frames\": [{ \"imageAsset\": { \"assetId\": \"$ASSET_ID\" } }],
    \"targetResolution\": [1280, 720]
  }" > operation.json

OPERATION_ID=$(jq -er '.id' operation.json)

You can add ?wait=true to short tasks, but the docs warn that the load balancer cuts connections at 60 seconds. For long tasks such as splats, submit without waiting.

4. Poll the operation

while true; do
  curl --fail-with-body --silent --show-error \
    "$WLT_API_BASE_URL/operations/$OPERATION_ID" \
    --header "WLT-Api-Key: $WLT_API_KEY" > result.json
  if jq -e '.done == true' result.json > /dev/null; then break; fi
  sleep 5
done

jq '.error, .response' result.json

done is the only terminal signal. When it is true, a non-null error means failure; otherwise response holds the result. You can also call POST /operations/{id}:wait for a bounded blocking wait, POST /operations/{id}:cancel to cancel, or pass a webhookUrl with the task to get a signed callback. Operations are kept for 30 days.

Assets and output links

  • Task output URLs work for 24 hours.
  • POST /assets/{id}:createReadUrl makes a fresh download link that lasts 15 minutes.
  • Upload links from :createUploadUrl last 30 minutes.
  • Asset states are CREATED, UPLOADING, READY and DELETED.

Rate limits

As of November 2026, World Labs calls its rate-limit table a placeholder. Submissions per minute, per hour and concurrent tasks are all "to be announced". What is documented:

  • Each task type has a concurrency cap, per account and service-wide. Submissions over the cap are refused, not queued.
  • Limits are shared between the web app, the API and the API playground. Extra keys don't add capacity.
  • Refusals return HTTP 429 with RATE_LIMIT_EXCEEDED, CONCURRENCY_LIMIT_EXCEEDED or TASK_UNAVAILABLE. Honor Retry-After and back off with jitter.

Design for this from day one: queue submissions, cap concurrency per project, store every operation ID, and never resubmit work that is still running.

Pricing

Prices below come from the Atlas API pricing table in the World Labs console (checked November 14, 2026). Frame prices are for standard 720p output, and RGBD includes the depth surcharge.

ItemCost
Credit rate1,000 credits per US dollar
images2PosedRGBD2 credits ($0.002) per input image
Atlas image generation, RGB / RGBD40 / 50 credits per output image
atlasGenerate (view generation), RGB / RGBDFirst frame 40 / 50 credits, each additional frame 8 / 10
atlasChisel, RGB / RGBDFirst frame 40 / 50 credits, each additional frame 8 / 10
posedImages2Splats, refined5,000 credits ($5) per request
posedImages2Splats, draft (refine: false)500 credits ($0.50) per request
splats2Mesh (mesh export)500 credits ($0.50) per world
Third-party model callsConverted at cost, provider's public rate per 1M tokens
Failed splat runsFree

New accounts get Developer Signup Credits: an account we checked in November 2026 received 10,000 (about $10), shown as expiring one year after signup. The amount may change.

Spend limits can be set per account or per project and reset each calendar month. At 100%, new tasks pause with HTTP 402 (SPEND_LIMIT_EXCEEDED). An empty balance returns CREDITS_UNAVAILABLE.

The sources conflict on expiry. The billing page says purchased credits don't expire, and the console pricing table states "API credits never expire". But the Terms of Service (November 10, 2026 version) say API credits expire one year after purchase, and the signup grant we saw showed an expiry one year after signup. Plan for the stricter reading. Our pricing calculator turns these numbers into a per-project estimate.

Terms worth knowing

The Terms of Service allow integrating Atlas into your commercial app and give you ownership of outputs from paid access. They forbid reselling the service or API credentials, using World Labs names and logos without permission, and using outputs to build a product that replicates Atlas's core functionality. Read the full terms before launch.

Next steps

FAQ

Related

Sources