Libraries for Python and Node.jsNew

# Python 3.11 and newer
$ pip install rendergrid

# Node.js 22 and newer
$ npm install @rendergrid/sdk

from rendergrid import Rendergrid

client = Rendergrid()  # the key is taken from RENDERGRID_API_KEY

creation = client.images.generate(
    model="nano-banana-pro",
    prompt="A ceramic mug on marble, soft window light",
    resolution="1K",
    aspect_ratio="4:5",
)
print(creation.id, creation.status, creation.cost)

result = creation.wait(timeout=180)  # polls no more often than once every 5 seconds
print(result.result_urls)

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

// the key is taken from RENDERGRID_API_KEY
const client = new Rendergrid();

const creation = await client.images.generate({
  model: "nano-banana-pro",
  prompt: "A ceramic mug on marble, soft window light",
  resolution: "1K",
  aspect_ratio: "4:5",
});
console.log(creation.id, creation.status, creation.cost);

// polls no more often than once every 5 seconds
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="A ceramic mug on marble",
    )
except rendergrid.InsufficientBalance as e:
    need, have = e.details["required"], e.details["available"]
    print("Required:", need, "available:", 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: "A ceramic mug on marble",
  });
} catch (error) {
  if (!(error instanceof RendergridError)) throw error;
  if (error.code === "ERR_INSUFFICIENT_BALANCE") {
    const { required, available } = error.details;
    console.log("Required:", required, "available:", 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(),  # the raw bytes, not 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: the raw bytes of the body
  });
  if (!event.test) {
    saveResult(event.id, event.status, event.result_urls);
  }
  res.sendStatus(204);
});