Paid credits never expire — buy once, use whenever you need them. Free-tier credits refresh every 30 days, topping your balance back up to 1,000 (never reducing it if it is already higher).

What happens when my balance hits zero?

Any API call that costs credits returns a 402 error. Status and read endpoints are always free, so you can still check job results and inspect existing simulations. Top up from the Billing page to resume.

Do multiple API keys share one balance?

Yes. Credits are tied to your Canvas Cloud AI user account, not to individual keys. All keys under the same account draw from the same pool.

How does the monthly free-tier refresh work?

30 days after your account is created, and every 30 days after that, your balance is topped up to 1,000 credits. If you already have more than 1,000 from a purchase, the refresh adds nothing.

Is a credit card required to get started?

No. Your account starts with 1,000 free credits the moment you register your Canvas Cloud AI key. No card is needed until you want to buy a credit pack.

Cloud World Model

Canvas Cloud AI Users

3 steps · 2 minutes

Get API Access

If you have a Canvas Cloud AI account, you already have everything you need. No sign-up, no waitlist — just your existing key.

Running headlessly or integrating with an AI assistant? See the Agent & Headless guide for Docker quickstart, MCP server setup, SDK, and CLI docs.

Step 01

Get your Canvas Cloud AI API key

Log in to Canvas Cloud AI, go to Account Settings → API Keys, and generate a key. It will start with cca_ and is shown only once — copy it immediately.

Bash

# Go to Canvas Cloud AI → Account Settings → API Keys
# Generate a new key — it starts with cca_
# Example: cca_live_abc123def456...

Step 02

Exchange it for a World Model key

Paste your Canvas Cloud AI key below. The World Model will verify your identity and return a permanent key scoped to this API.

Step 03

Start calling the API

Your key is live — copy and run

Use your World Model key (cwm_live_...) in the Authorization header for every request. You now have access to simulations, chaos engineering, multi-cloud analysis, and more.

curl -X POST https://cloudworldmodel.ai/api/simulations \
  -H "Authorization: Bearer cwm_live_your_world_model_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My First Simulation",
    "provider": "aws",
    "region": "us-east-1"
  }'

Good to know

Your key, your scopes

World Model keys issued via Canvas Cloud AI start with read and write access. Visit the Admin Key Management page (/admin/keys) if you need admin-scoped key setup.

One Canvas Cloud AI key → many World Model keys

You can register multiple times with the same Canvas Cloud AI key to create separate keys for different projects or agents.

Email verification required

Your Canvas Cloud AI account email must be verified before you can get a World Model key. Check your Canvas Cloud AI account if you see a 403 error.

Rate limits

New keys start at 1,000 requests per hour. The limit is tied to your World Model key, not your Canvas Cloud AI key.

Credit costs

Your account starts with 1,000 free credits per month — refreshed automatically every 30 days. Status and read endpoints are always free.

Call type	Description	Credits
Simulation step	Run one step of a cloud simulation	1
RL episode step	Single action in a reinforcement learning episode	1
Chaos job	Inject a failure scenario and evaluate resilience	5
Multi-cloud strategy job	Generate and score multi-cloud architecture variants	5
AI explanation	GPT-powered analysis, bottleneck insight, or optimization tip	10
Status / read endpoints	Fetch job status, metrics, or list resources	Free

Need more? Buy a credit pack — Starter $9 / 10k, Professional $49 / 100k, Enterprise $299 / 1M. Paid credits never expire.

Frequently asked questions

Ready to go deeper?

The full API reference covers simulations, chaos engineering, RL training, multi-cloud analysis, and more.