Saldo

01Consultar el saldo

Basta con la clave de API. El endpoint no tiene cuerpo ni parámetros, y la llamada no hace ningún cargo.

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()
# cadena -> Decimal, no float
available = Decimal(response.json()["available"])
print(available)

// Node.js 22+, archivo .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}`);
}
// cadena: no la conviertas en Number
const { available } = await response.json();
console.log(available);

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

02El dinero son cadenas de texto

Los tres importes son cadenas decimales en dólares estadounidenses con cuatro decimales. Conserva esa precisión: en Python usa Decimal; en otros lenguajes, unidades enteras de $0,0001. Los números binarios de coma flotante no sirven para el dinero.

03Cuándo se hace el cargo

El cargo se hace al aceptar la solicitud, antes de empezar el trabajo. Si la imagen no sale, el cargo se devuelve por sí solo.

Leer el saldo no reserva nada: mientras lo lees, otra solicitud simultánea puede gastar el dinero. Por eso gestiona siempre el 402, incluso si la comprobación fue bien.

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 }
  }
}

04Cómo leer el saldo

• Comprueba el saldo antes de enviar un lote de solicitudes y de vez en cuando durante el trabajo.
• Leer el saldo cuenta para el límite de solicitudes de la cuenta, pero no ocupa un slot de generación ni comparte el intervalo del sondeo de las tareas.
• No te fíes de la comprobación como garantía: la respuesta decisiva la da la propia solicitud de generación.

05Recarga

La API pública no tiene un endpoint de recarga. El saldo se recarga en USDT en la sección «Saldo y recargas» del portal o a través de un gestor de cuenta. El saldo y la lista de operaciones también se ven allí.

FAQPreguntas frecuentes