Instances

Create a new compute instance. The optional mode field is retained for legacy compatibility. Its value does not select execution mode; routing is derived from num_gpus. New integrations should omit mode and use GET /v2/specs for available configurations.

SSH access: pass an SSH public key in the public_key field to seed the instance's authorized_keys. If omitted, Thunder generates a key pair and returns the private key in the response (it is only returned once — store it immediately).

Note: SSH keys saved in your account (Authentication section of the console) are a separate store and are NOT automatically attached to new instances. To use one of those keys, copy its public key material into the public_key field on this request.

post/instances/create

Request

  • Base URL
    https://api.thundercompute.com:8443/v1
  • Auth
    API key in header Authorization

Request body

cpu_coresinteger required
disk_size_gbinteger required
gpu_typestring required
mode'prototyping' | 'production'
num_gpusinteger required
public_keystring

Optional SSH public key material to seed authorized_keys. If omitted, a key pair is generated and the private key returned.

templatestring required

Example request

{
  "cpu_cores": 4,
  "disk_size_gb": 100,
  "gpu_type": "H100",
  "num_gpus": 1,
  "template": "ubuntu-22.04"
}

Response

Created

identifierinteger required
keystring required
uuidstring required

Changes

    • info

      request property deprecated

    • breaking

      added the new required request property

    • breaking

      added the new required request property

    • breaking

      added the new required request property

    • breaking

      added the new required request property

    • breaking

      added the new required request property

    • breaking

      removed subschema #1 from the request body oneOf list

    • breaking

      the request's body type changed from no type to object

    • info

      added the new optional request property

    • info

      added the new optional request property