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
- 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.
- Give the key the scopes it needs:
tasks.create,operations.read,assets.createandassets.read(plusassets.deleteif you delete assets). - Copy the secret when it appears. It cannot be shown again. Keep it server-side.
Base URL and auth:
| Item | Value |
|---|---|
| Base URL | https://api.atlas.worldlabs.ai/api/v2 |
| Auth header | WLT-Api-Key: your_key |
| Health check | GET /health (no key needed) |
| Idempotency | Optional 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
| Task | Use it to |
|---|---|
atlasTextToImage | Make a starting image from a text description |
images2PosedRGBD | Estimate camera pose and depth for your images |
atlasGenerate | Render new views of a scene at target cameras (frames, not video) |
atlasChisel | Render a layout from depth, restyle a scene, or edit masked regions |
posedImages2Splats | Reconstruct a Gaussian splat (SPZ) from 2 to 512 posed frames |
splats2Mesh | Convert 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}:createReadUrlmakes a fresh download link that lasts 15 minutes.- Upload links from
:createUploadUrllast 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
429withRATE_LIMIT_EXCEEDED,CONCURRENCY_LIMIT_EXCEEDEDorTASK_UNAVAILABLE. HonorRetry-Afterand 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.
| Item | Cost |
|---|---|
| Credit rate | 1,000 credits per US dollar |
images2PosedRGBD | 2 credits ($0.002) per input image |
| Atlas image generation, RGB / RGBD | 40 / 50 credits per output image |
atlasGenerate (view generation), RGB / RGBD | First frame 40 / 50 credits, each additional frame 8 / 10 |
atlasChisel, RGB / RGBD | First frame 40 / 50 credits, each additional frame 8 / 10 |
posedImages2Splats, refined | 5,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 calls | Converted at cost, provider's public rate per 1M tokens |
| Failed splat runs | Free |
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
- Convert splats into game-ready meshes with Splat to mesh.
- Learn the full workflow in the Atlas guide.
- Compare with the older World API in Atlas vs Marble.