gpu.nz GPU Cloud

Adds an SSH public key (a line from a .pub file) to the account. Needs user:write.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "add_ssh_key",
    "arguments": {
      "public_key": "..."
    }
  }
}

Rents the server of an offer and starts it with a template. Billing starts right away and runs every minute until you stop or destroy it. Confirm the price with the user first. Needs instances:write. The response has the instance id; poll get_instance until status is running (usually 1–5 minutes).

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "create_instance",
    "arguments": {
      "offer_id": "...",
      "template": "...",
      "disk_gb": 0
    }
  }
}

Destroys a server and deletes its disk for good; billing stops completely. Irreversible: confirm with the user. Needs instances:write.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "destroy_instance",
    "arguments": {
      "instance_id": "..."
    }
  }
}

How much GPU memory an AI model needs (LLMs such as Qwen, DeepSeek, Llama, Gemma, GPT-OSS; image and video models such as FLUX, SDXL, Wan) at a given precision and context length, and which GPUs on gpu.nz fit it with their current price. Call without `model` to list the known models.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "estimate_vram",
    "arguments": {}
  }
}

The signed-in account and its balance, hourly burn and runway. Needs a key with user:read and billing:read.

Takes no parameters.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_account",
    "arguments": {}
  }
}

Status, SSH command, app URLs (ComfyUI, Jupyter, chat…), price and cost so far of one server. The root password is left out unless include_password is true (your SSH keys are installed on every server).

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_instance",
    "arguments": {
      "instance_id": "..."
    }
  }
}

The last lines of a server's container log: boot progress, app start-up, errors. Needs instances:read.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_instance_logs",
    "arguments": {
      "instance_id": "..."
    }
  }
}

Details and the current price of one offer by id (from search_offers).

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_offer",
    "arguments": {
      "offer_id": "..."
    }
  }
}

GPU models available on gpu.nz right now with VRAM, class and the cheapest hourly price per GPU. Use it to pick a gpu_slug for search_offers.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "list_gpu_models",
    "arguments": {}
  }
}

Your rented servers with status, GPU, price and SSH command. Needs instances:read.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "list_instances",
    "arguments": {}
  }
}

SSH public keys on the account; they are installed on new servers. Needs user:read.

Takes no parameters.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "list_ssh_keys",
    "arguments": {}
  }
}

Ready environments a server can start with: ComfyUI, Stable Diffusion Forge, Ollama + Open WebUI, vLLM, Jupyter/PyTorch, Kohya, FluxGym, Unsloth, chats with preloaded models, plain Ubuntu + CUDA, or a custom Docker image. Pass `slug` as `template` to create_instance.

Takes no parameters.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "list_templates",
    "arguments": {}
  }
}

Search rentable GPU servers (offers) with live prices. Returns the cheapest matches first unless `order` says otherwise. Each result has an offer id for create_instance.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "search_offers",
    "arguments": {}
  }
}

Starts a stopped server again; GPU billing resumes. Confirm with the user. Needs instances:write.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "start_instance",
    "arguments": {
      "instance_id": "..."
    }
  }
}

Stops a running server: the GPU is released and billing drops to the disk only. Data on the disk is kept and the server can be started again (the GPU may then be taken by someone else; gpu.nz finds a replacement when it is). Needs instances:write.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "stop_instance",
    "arguments": {
      "instance_id": "..."
    }
  }
}

A link to the balance top-up page (SBP, crypto) for the user to open in a browser; payments never happen through the API. Optionally pre-fills the amount.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "topup_link",
    "arguments": {}
  }
}