Баланс

01Узнать баланс

Достаточно ключа API. У метода нет тела и параметров, а вызов ничего не списывает.

curl --fail-with-body --max-time 20 \
  https://api.rendergrid.io/api/public/v1/balance \
  -H "Authorization: Bearer $RENDERGRID_API_KEY"

import os
from decimal import Decimal
import requests

key = os.environ["RENDERGRID_API_KEY"]
response = requests.get(
    "https://api.rendergrid.io/api/public/v1/balance",
    headers={"Authorization": f"Bearer {key}"},
    timeout=(5, 20),
)
response.raise_for_status()
# строка -> Decimal, не float
available = Decimal(response.json()["available"])
print(available)

// Node.js 22+, файл .mjs
const url = "https://api.rendergrid.io/api/public/v1/balance";
const key = process.env.RENDERGRID_API_KEY;
const response = await fetch(url, {
  headers: { Authorization: `Bearer ${key}` },
  signal: AbortSignal.timeout(20_000),
});
if (!response.ok) {
  const body = await response.text();
  throw new Error(`HTTP ${response.status}: ${body}`);
}
// строка: не превращайте её в Number
const { available } = await response.json();
console.log(available);

{
  "currency": "USD",
  "balance": "42.5000",
  "overdraft_limit": "0.0000",
  "available": "42.5000"
}

02Деньги — это строки

Все три суммы — десятичные строки в долларах с четырьмя знаками после запятой. Сохраняйте эту точность: в Python берите Decimal, в других языках — целые единицы по $0,0001. Двоичные числа с плавающей точкой для денег не годятся.

03Когда списываются деньги

Сумма списывается при приёме запроса, до начала работы. Если картинка не получилась, списание возвращается само.

Чтение баланса ничего не резервирует: пока вы его читаете, соседний запрос может потратить деньги. Поэтому всегда обрабатывайте 402, даже если проверка прошла.

HTTP/1.1 402 Payment Required

{
  "error": {
    "code": "ERR_INSUFFICIENT_BALANCE",
    "message": "insufficient api wallet balance",
    "details": {
      "required": "0.0400",
      "available": "0.0100",
      "top_up_url": "/portal/billing"
    }
  }
}

HTTP/1.1 402 Payment Required

{
  "error": {
    "code": "ERR_INSUFFICIENT_BALANCE",
    "message": "monthly budget exceeded",
    "details": { "reason": "monthly_budget_exceeded", "cap": 50.0 }
  }
}

04Как читать баланс

• Проверяйте баланс перед пачкой запросов и время от времени во время работы.
• Чтение баланса входит в лимит запросов аккаунта, но не занимает слот генерации и не делит интервал опроса заданий.
• Не опирайтесь на проверку как на гарантию: решающий ответ даёт сам запрос генерации.

05Пополнение

В публичном API нет метода пополнения. Баланс пополняют в USDT в разделе «Баланс и пополнение» кабинета или через менеджера. Баланс и список операций видны там же.

FAQЧастые вопросы