WBX Sandbox
Jobs and batches

Compute classes

A compute class is the service level for your sandboxes and jobs: which servers the work runs on, how they are chosen and the price. It is a declared level of service, not a guaranteed speed.

Classes

ClassRuns onGood for
economythe lowest-cost servers (default)Python, small jobs, light AI tasks
balancedbalance of price, load and performanceeveryday development, automation, browsers
performanceonly servers with the highest measured performance (formerly cpu-fast)builds, tests, heavy computation
memoryservers with the most free memory; at least 2 vCPU and 8 GBdata processing that needs a lot of RAM
dedicatedonly servers reserved for your organizationenterprise workloads (on request)

Which class is used

compute_class in the request wins; without it your account's default class is used ( Settings → Compute Preferences ), and without a default economy. The server decides – SDKs and MCP send nothing when you don't set it. An unknown class is a 400 error, a class your plan does not include is 403, a class that is temporarily unavailable is 409. Your request is never moved to another class.

from wbxsandbox import Sandbox, run_job, compute_preferences, set_default_compute_class

print(compute_preferences())                      # classes, prices, your default
set_default_compute_class("balanced")
run_job(command="make -j4", compute_class="performance", optimize_for="price", max_cost="0.10")
Sandbox.create(template="base", compute_class="memory")
curl -s https://sandbox.wbx.cz/v1/compute/preferences -H "Authorization: Bearer YOUR_API_KEY"
curl -s -X PUT https://sandbox.wbx.cz/v1/compute/preferences -H "Authorization: Bearer YOUR_API_KEY" -d '{"default_compute_class": "balanced"}'
curl -s -X POST https://sandbox.wbx.cz/v1/jobs -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"command": "make -j4", "compute_class": "performance", "optimize_for": "price", "max_cost": "0.10"}'

Price

Each class has its own price relative to your plan's rates (shown in Compute Preferences). The price of a sandbox or job is fixed when it is created or accepted – later changes of the price list or your default do not change running sandboxes or accepted jobs. The worst-case cost (max_cost, budget) uses the class price.

Choosing a server inside the class

optimize_for (price, balanced or performance) picks the server inside the class; it never changes the class or its price. When no server of the class is free right now, creating a sandbox fails with 503 and a job waits in the queue. Responses include the resulting compute_class (jobs also class_price).

placement (auto, fast, spread) from earlier versions still works; optimize_for takes precedence.