Create a GPU instance
Provision a dedicated GPU instance. Most instances are running within a few minutes. Specify either gpu_type (auto-deploy) or instance_type_id (specific config from /instances/types).
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
Required with term_months (400 without it): names the purchase, so a retried request never buys a second term. Sending the same key again answers 200 with the instance it already bought and Idempotent-Replayed: true; no second debit or machine. A key whose term was returned (its instance never started) answers 409: use a new key.
255Body
Provide either gpu_type (Runcrate picks an available configuration for that GPU. When the best-priced option's starts are failing, it may pick one up to 10% dearer that is starting reliably; the response shows the price you'll pay (cost_per_hour).) or instance_type_id (specific config from /instances/types).
Let a community host run it (host_tier: community). Off by default: only datacenter machines are picked, and a community instance_type_id is refused. Never with term_months. Refused with 409 sensitive_secrets_on_community_host while the environment has Sensitive secrets: they are never sent to a community host.
Run it only on a machine whose address is registered in the European Economic Area (the EU, Iceland, Liechtenstein and Norway). Only types whose region positively names an EEA country are offered. The first check of the machine's address runs after the machine is rented: an address registered anywhere else, or that cannot be verified, is released before it runs and is never charged, and the launch moves to the next option. When none is left the instance fails with No machine in the European Economic Area could be verified for this launch; nothing was charged. The secrets the machine pulls from Runcrate, and its other machine calls, are served only to an address registered in the EEA. The launch script itself (your startup commands) is on most machine types sent when the machine is created, so it is already on the host when the check runs; on the others it is sent only after the address passes. So eea_only filters where machines are rented and is not a guarantee of where your data is processed, and it reads where an address is registered, not exactly where the machine stands. With storage_id, only machine types that receive the script after the address is checked are offered; otherwise the request is refused with a 400 (A volume cannot be attached to an eea_only launch on this machine type yet) and nothing is rented. Off by default. Also a field of schedules and jobs; not supported on clusters.
Environment variables for this launch, added to the environment's secrets (a name set in both takes this value). Each item is { "key": "NAME", "value": "..." }: names are letters, digits and underscores, not starting with a digit or RUNCRATE_; values up to 32 KB, 64 KB in all. They are stored encrypted, never returned, and the machine reads them at boot from /etc/runcrate/secrets.env.
Buy a prepaid term for this instance at the discount listed in subscription_terms of GET /instances/types (a length the type does not list is refused with 409 and details.reason: term_not_offered), paid in full from credit when the instance is created. Requires an Idempotency-Key header (or idempotency_key) and expected_total_price. Refused (403) for an agent sign-in (MCP or CLI agent token), with a message the agent can relay: a person buys the term in the dashboard. API keys can buy. The term starts when the GPU is running and can't be cancelled: the instance can't be terminated before it ends, and the unused time comes back as credit only if Runcrate ends it early or its machine is lost. A term of 3 months or more, or over $1,000, needs a verified identity (dashboard, once per account). Not allowed with max_runtime_minutes or idle_shutdown_minutes. Omit for hourly billing.
1, 3, 6, 12 Required with term_months: the term's total_price from subscription_terms of GET /instances/types, in USD. If the price differs by $0.01 or more when the instance is created, nothing is bought and the answer is 409 with details.reason: price_changed and the current details.total_price_usd.
On demand (without term_months): the hourly_rate you were shown in GET /instances/types, in USD. If the live price is more than 2% above it when the instance is created, nothing launches and the answer is 409 with details.reason: price_changed, the live details.hourly_rate_usd and the details.expected_hourly_rate_usd you sent; send the new rate to launch at it. A lower live price launches at the lower price. Omit it to launch at the live price.