For developers

gpu.nz API

A REST API for renting GPU servers in rubles: search offers, rent, manage servers, check the balance and keep API keys. It works the same from curl, Python, JavaScript, CI and AI agents.

Base URL

https://gpu.nz/api/v1

Quickstart

Five steps from a key to a running server. Examples in curl, Python and JavaScript.

01Get a key
Create one in the console: Keys → API keys. Or run gpunz login and the key is issued for you.
```
export GPUNZ_API_KEY="gpz_…"
```
02Find a server
GET /offers with filters: model, GPU count, country, price. Results are sorted by price.
```
curl -X GET 'https://gpu.nz/api/v1/offers?gpu=rtx-4090-24gb&order=price&limit=5'
```

03Rent it

POST /instances with an Idempotency-Key header. A repeat with the same key does not create a second server.

curl -X POST 'https://gpu.nz/api/v1/instances' \
  -H "Authorization: Bearer $GPUNZ_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "offer_id": "o_4Jx9Q2",
  "template": "pytorch-cuda12",
  "disk_gb": 40,
  "name": "trainer"
}'

04Connect
When the status becomes running, the response carries a ready ssh command and the web interface links.
```
curl -X GET 'https://gpu.nz/api/v1/instances/i_8f2KQ1xZ' \
  -H "Authorization: Bearer $GPUNZ_API_KEY"
```

05Stop or destroy

POST /instances/{id}/stop stops it: only the disk is billed. DELETE /instances/{id} destroys it for good.

curl -X POST 'https://gpu.nz/api/v1/instances/i_8f2KQ1xZ/stop' \
  -H "Authorization: Bearer $GPUNZ_API_KEY"

curl -X DELETE 'https://gpu.nz/api/v1/instances/i_8f2KQ1xZ' \
  -H "Authorization: Bearer $GPUNZ_API_KEY"

For AI agents and tools

Plain-text docs for language models: /llms.txt (summary) and /llms-full.txt (full reference). OpenAPI 3.1 schema: /api/v1/openapi.json.

/llms.txt /llms-full.txt /api/v1/openapi.json

What to know about servers

The same model works through the API and the console.

Connect over SSH

Create a key once. On Windows open PowerShell; on macOS and Linux open Terminal:

ComfyUI, Jupyter and other interfaces

Templates with a web interface open with the Open button on the server page. The link contains an access token: do not share it, because anyone with it can open the server without a password. Jupyter uses HTTPS with the server's certificate, so your browser may warn about an insecure connection. That is expected.

Upload and download files

From your machine to the server and back, with scp or rsync:

How not to overpay

A stopped server costs only its disk storage, usually 1–10 ₽ an hour. Stop it during breaks. Deleting a server erases its data for good. Download your results first. When the balance covers less than a day of storage, servers stop automatically. At zero they are deleted after 24 hours. We warn you in advance. A stopped server may fail to restart if another customer takes the GPU on that host. Your data is kept.

Full reference for every endpoint · Write to us on Telegram