Bibliotecas para Python y Node.jsNuevo

# Python 3.11 y posteriores
$ pip install rendergrid

# Node.js 22 y posteriores
$ npm install @rendergrid/sdk

from rendergrid import Rendergrid

client = Rendergrid()  # la clave se toma de RENDERGRID_API_KEY

creation = client.images.generate(
    model="nano-banana-pro",
    prompt="Taza de cerámica sobre mármol, luz suave de ventana",
    resolution="1K",
    aspect_ratio="4:5",
)
print(creation.id, creation.status, creation.cost)

result = creation.wait(timeout=180)  # sondea como máximo una vez cada 5 segundos
print(result.result_urls)

import { Rendergrid } from "@rendergrid/sdk";

// la clave se toma de RENDERGRID_API_KEY
const client = new Rendergrid();

const creation = await client.images.generate({
  model: "nano-banana-pro",
  prompt: "Taza de cerámica sobre mármol, luz suave de ventana",
  resolution: "1K",
  aspect_ratio: "4:5",
});
console.log(creation.id, creation.status, creation.cost);

// sondea como máximo una vez cada 5 segundos
const result = await creation.wait({ timeoutMs: 180_000 });
console.log(result.result_urls);

import time
import rendergrid

try:
    creation = client.images.generate(
        model="nano-banana-pro",
        prompt="Taza de cerámica sobre mármol",
    )
except rendergrid.InsufficientBalance as e:
    need, have = e.details["required"], e.details["available"]
    print("Hace falta:", need, "disponible:", have)
except rendergrid.RateLimited as e:
    time.sleep(e.retry_after)
except rendergrid.APIError as e:
    print(e.status, e.code, e.retryable)

import { RendergridError } from "@rendergrid/sdk";

try {
  const creation = await client.images.generate({
    model: "nano-banana-pro",
    prompt: "Taza de cerámica sobre mármol",
  });
} catch (error) {
  if (!(error instanceof RendergridError)) throw error;
  if (error.code === "ERR_INSUFFICIENT_BALANCE") {
    const { required, available } = error.details;
    console.log("Hace falta:", required, "disponible:", available);
  } else {
    console.log(error.status, error.code, error.retryable);
  }
}

import os
from flask import Flask, request
from rendergrid.webhooks import verify

app = Flask(__name__)

@app.post("/webhooks/rendergrid")
def hook():
    event = verify(
        secret=os.environ["RENDERGRID_WEBHOOK_SECRET"],
        headers=request.headers,
        body=request.get_data(),  # los bytes originales, no request.json
    )
    if not event.get("test"):
        save_result(
            event["id"], event["status"], event.get("result_urls")
        )
    return "", 204

import express from "express";
import { verifyWebhook } from "@rendergrid/sdk/webhooks";

const app = express();
const raw = express.raw({ type: "application/json" });

app.post("/webhooks/rendergrid", raw, (req, res) => {
  const event = verifyWebhook({
    secret: process.env.RENDERGRID_WEBHOOK_SECRET,
    headers: req.headers,
    body: req.body, // Buffer: los bytes originales del cuerpo
  });
  if (!event.test) {
    saveResult(event.id, event.status, event.result_urls);
  }
  res.sendStatus(204);
});