Основы
| Базовый URL | https://lowcostgpu.com/v1 |
|---|---|
| Аутентификация | Authorization: Bearer pg_live_… |
| Формат | JSON на входе, JSON на выходе, UTF-8. Ошибки: {"error":{"code","message"}} |
| Лимиты запросов | 120 запросов в минуту (увеличивается с историей аккаунта) — при превышении: 429 + Retry-After |
Публичные эндпоинты — попробуйте прямо сейчас
GET /v1/gpus/pricing
Полный прайс-лист в виде данных: все модели (83), по три режима на каждую, медианы рынка и само правило ценообразования.
curl https://lowcostgpu.com/v1/gpus/pricing{
"object": "gpu_pricing",
"currency": "USD",
"billing": "per_second",
"price_rule": "market_median * 0.70, rounded down; …",
"market_snapshot": "2026-10-19",
"data": [
{
"slug": "h100-sxm",
"name": "NVIDIA H100 SXM",
"vram_gb": 80,
"price_per_gpu_hour": {
"on_demand": 1.680,
"interruptible": 0.840,
"reserved": 1.092
},
"market_median": 2.4001,
"available_gpus": 50
}, …
]
}GET /v1/offers
Список машин в реальном времени. Фильтры: gpu (slug), region, num_min, price_max ($/ч за машину целиком), limit (≤100).
curl "https://lowcostgpu.com/v1/offers?gpu=rtx-4090&num_min=2&limit=3"Аутентифицированные эндпоинты
Создайте ключ в разделе Консоль → Ключи API (документация), затем:
GET /v1/balance
curl -H "Authorization: Bearer " https://lowcostgpu.com/v1/balance
{ "object": "balance", "currency": "USD", "balance": 41.2183, "month_spend": 12.8402 }POST /v1/instances
Развернуть на машине из /v1/offers. Тело запроса: machine_id (обязательно), template, disk_gb, type (od | interruptible | res).
curl -X POST -H "Authorization: Bearer " \
-H "Content-Type: application/json" \
-d '{"machine_id":"m-1d29c04a","template":"vllm","disk_gb":80,"type":"od"}' \
https://lowcostgpu.com/v1/instances
{ "object": "instance", "id": "i-52ab77c1", "status": "running",
"hostname": "i-52ab77c1.lowcostgpu.com", "price_hr": 1.5983, … }GET /v1/instances · GET /v1/instances/{id}
Получить список активных инстансов / один инстанс (состояние, цена, имя хоста, временные метки). Биллинг считается на момент чтения, поэтому цифры актуальны с точностью до секунды.
POST /v1/instances/{id}/actions
-d '{"action":"stop"}' # or start | destroyDELETE /v1/instances/{id}
Псевдоним для действия «Уничтожить». Диск инстанса стирается; подключённые тома сохраняются.
Ошибки
| Статус | код | Значение |
|---|---|---|
| 401 | unauthorized | Отсутствует или не распознан Bearer-ключ |
| 404 | not_found / no_route | Неизвестный инстанс или эндпоинт |
| 409 | deploy_failed / action_failed | Бизнес-правило отклонило запрос — причина указана в сообщении (баланс, мощность, состояние) |
| 422 | missing_machine / bad_action | Неверный формат запроса |
| 429 | rate_limited | Снизьте частоту запросов; учитывайте Retry-After |
Предпочитаете обёртку? CLI и Python SDK покрывают этот API один к одному.