Run a job
Run one command on its own fresh GPU machine, or a group of them with count or params. Runcrate tries the GPUs in gpu_type in order and, when none has capacity, keeps the job queued and tries again (1, 2, 4, then every 5 minutes) for up to capacity_wait_minutes. It runs the command with bash in /workspace, streams its output to GET /jobs/{id}/logs, and stops the machine as soon as the command exits, hits max_runtime_minutes or is cancelled. A failed attempt is retried on a new machine under max_retries. Files written under /workspace are saved back to the volume (storage_id) when each machine stops. The machine also shows in GET /instances while it runs. With capacity_wait_minutes: 0, a job that could not be launched answers the error with details.job_id, and that job is failed. Send an Idempotency-Key header to retry safely.
Authorizations
Use a Runcrate API key with the rc_live_* prefix as the bearer token. Create one at https://www.runcrate.ai/dashboard/api-keys.
Headers
Unique per environment for 24 hours. Sending the same request again answers the original job (or group) with 200 and Idempotent-Replayed: true instead of starting another; the same key with a different request is a 409 with details.reason: idempotency_conflict.
255Body
GPU model (e.g. A4000, H100), as listed by GET /instances/types, or a list to try in order, e.g. ["H100", "A100-80GB:2"]. :N sets that entry's GPU count (1, 2, 4 or 8); entries without one use gpu_count. H200 takes either H200 card, SXM or NVL, and the job's gpu_type says which it ran on (H200 or H200_nvl); H200_sxm asks for the SXM card only, H200_nvl for the NVL only.
Container image to run the command in. /workspace is mounted and the image is pulled before the max runtime starts. The GPUs are passed into the container only on machines with the NVIDIA container runtime; otherwise the job log says so and the command runs without GPUs. The image needs bash or sh.
Environment variables for the command, as { "KEY": "value" }, added to the environment's secrets (a name set in both takes this value). Keys match ^[A-Za-z_][A-Za-z0-9_]*$ and don't start with RUNCRATE_; at most 200 keys, values up to 32 KB, 64 KB in total with the secrets. Values are stored only encrypted and never returned.
Run it only on a machine whose address is registered in the European Economic Area (the EU, Iceland, Liechtenstein and Norway). Machines in other countries are not offered, and a machine whose address cannot be verified there is released before it runs and never charged; the job waits for capacity as it does for any machine. The check reads where the address is registered, not exactly where the machine stands. Off by default.
Response
A replay of an earlier request with the same Idempotency-Key: the job (or group) it created, as it is now. The Idempotent-Replayed: true header is set.