API gpu.nz
REST API для аренды GPU-серверов в рублях: искать предложения, арендовать, управлять серверами, смотреть баланс и вести API-ключи. Одинаково работает из curl, Python, JavaScript, CI и ИИ-агентов.
https://gpu.nz/api/v1Быстрый старт
Пять шагов от ключа до работающего сервера. Примеры — на curl, Python и JavaScript.
01Получите ключ
Создайте ключ в консоли: «Ключи» → «API-ключи». Или выполните gpunz login — ключ появится сам.
export GPUNZ_API_KEY="gpz_…"02Найдите сервер
GET /offers с фильтрами: модель, число GPU, страна, цена. Выдача отсортирована по цене.
curl -X GET 'https://gpu.nz/api/v1/offers?gpu=rtx-4090-24gb&order=price&limit=5'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" }'04Подключитесь
Когда статус станет running, в ответе появится готовая ssh-команда и ссылки на веб-интерфейсы.
curl -X GET 'https://gpu.nz/api/v1/instances/i_8f2KQ1xZ' \ -H "Authorization: Bearer $GPUNZ_API_KEY"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 часа. Мы предупреждаем заранее. Остановленный сервер может не запуститься снова, если видеокарту на этом хосте занял другой клиент. Данные при этом сохраняются.