Доступность GPU обновляется каждую минуту
gpu.nz
Для разработчиков

API gpu.nz

REST API для аренды GPU-серверов в рублях: искать предложения, арендовать, управлять серверами, смотреть баланс и вести API-ключи. Одинаково работает из curl, Python, JavaScript, CI и ИИ-агентов.

Базовый адрес
https://gpu.nz/api/v1

Быстрый старт

Пять шагов от ключа до работающего сервера. Примеры — на curl, Python и JavaScript.

  1. 01Получите ключ

    Создайте ключ в консоли: «Ключи» → «API-ключи». Или выполните gpunz login — ключ появится сам.

    export GPUNZ_API_KEY="gpz_…"
  2. 02Найдите сервер

    GET /offers с фильтрами: модель, число GPU, страна, цена. Выдача отсортирована по цене.

    curl -X GET 'https://gpu.nz/api/v1/offers?gpu=rtx-4090-24gb&order=price&limit=5'
  3. 03Арендуйте

    POST /instances с заголовком Idempotency-Key. Повтор с тем же ключом не создаст второй сервер.

    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"
    }'
  4. 04Подключитесь

    Когда статус станет running, в ответе появится готовая ssh-команда и ссылки на веб-интерфейсы.

    curl -X GET 'https://gpu.nz/api/v1/instances/i_8f2KQ1xZ' \
      -H "Authorization: Bearer $GPUNZ_API_KEY"
  5. 05Остановите или удалите

    POST /instances/{id}/stop — остановить, оплачивается только диск. DELETE /instances/{id} — удалить навсегда.

    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"

Для ИИ-агентов и инструментов

Текстовые версии документации для языковых моделей: /llms.txt (кратко) и /llms-full.txt (полный справочник). Схема OpenAPI 3.1: /api/v1/openapi.json.

Что важно знать о серверах

Одна и та же модель работает через API и через консоль.

Подключение по SSH

Создайте ключ один раз. В Windows откройте PowerShell, в macOS и Linux — Терминал:

ComfyUI, Jupyter и другие интерфейсы

Шаблоны с веб-интерфейсом открываются кнопкой «Открыть» на странице сервера. Ссылка содержит токен доступа: не публикуйте её, по ней сервер открыт без пароля. Jupyter использует HTTPS с сертификатом сервера, поэтому браузер может предупредить о небезопасном соединении. Это ожидаемо.

Загрузка и скачивание файлов

С компьютера на сервер и обратно — через scp или rsync:

Как не тратить лишнего

Остановленный сервер стоит только хранение диска, обычно 1–10 ₽ в час. Останавливайте его на перерывы. Удаление сервера стирает данные навсегда. Скачайте результаты до удаления. При остатке баланса на сутки хранения серверы останавливаются автоматически, при нуле — удаляются через 24 часа. Мы предупреждаем заранее. Остановленный сервер может не запуститься снова, если видеокарту на этом хосте занял другой клиент. Данные при этом сохраняются.

Полный справочник по всем эндпоинтам · напишите в Telegram