Python 和 Node.js 客户端库新

# Python 3.11 及更高版本
$ pip install rendergrid

# Node.js 22 及更高版本
$ npm install @rendergrid/sdk

from rendergrid import Rendergrid

client = Rendergrid()  # 密钥取自 RENDERGRID_API_KEY

creation = client.images.generate(
    model="nano-banana-pro",
    prompt="大理石上的陶瓷杯，柔和的窗光",
    resolution="1K",
    aspect_ratio="4:5",
)
print(creation.id, creation.status, creation.cost)

result = creation.wait(timeout=180)  # 轮询频率不高于每 5 秒一次
print(result.result_urls)

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

// 密钥取自 RENDERGRID_API_KEY
const client = new Rendergrid();

const creation = await client.images.generate({
  model: "nano-banana-pro",
  prompt: "大理石上的陶瓷杯，柔和的窗光",
  resolution: "1K",
  aspect_ratio: "4:5",
});
console.log(creation.id, creation.status, creation.cost);

// 轮询频率不高于每 5 秒一次
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="大理石上的陶瓷杯",
    )
except rendergrid.InsufficientBalance as e:
    need, have = e.details["required"], e.details["available"]
    print("需要：", need, "可用：", 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: "大理石上的陶瓷杯",
  });
} catch (error) {
  if (!(error instanceof RendergridError)) throw error;
  if (error.code === "ERR_INSUFFICIENT_BALANCE") {
    const { required, available } = error.details;
    console.log("需要：", required, "可用：", 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(),  # 原始字节，而不是 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：请求体的原始字节
  });
  if (!event.test) {
    saveResult(event.id, event.status, event.result_urls);
  }
  res.sendStatus(204);
});