Nano Banana 2.1 API 教程：五分钟走完流程，生成第一张图片

# 需要 bash、curl 和 uuidgen。每个请求使用一个幂等键。
IDEMPOTENCY_KEY="$(uuidgen)" || exit 1
curl --fail-with-body --max-time 30 \
  -X POST https://api.rendergrid.io/api/public/v1/images/generate \
  -H "Authorization: Bearer $RENDERGRID_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
    "model": "nano-banana-2.1",
    "prompt": "浅色书桌上摆着一本合上的亚麻封面笔记本、一支木铅笔和一只白瓷杯。镜头略微俯视，三个物件集中在画面中央，外侧留白均衡。左边窗光柔和，能看清封面织纹、木纹与陶瓷釉面。不出现文字、标志、人物或水印。",
    "resolution": "1K",
    "aspect_ratio": "1:1"
  }'

import os
import uuid

import requests

API = "https://api.rendergrid.io/api/public/v1"
KEY = os.environ["RENDERGRID_API_KEY"]
PROMPT = "浅色书桌上摆着一本合上的亚麻封面笔记本、一支木铅笔和一只白瓷杯。镜头略微俯视，三个物件集中在画面中央，外侧留白均衡。左边窗光柔和，能看清封面织纹、木纹与陶瓷釉面。不出现文字、标志、人物或水印。"

response = requests.post(
    f"{API}/images/generate",
    headers={
        "Authorization": f"Bearer {KEY}",
        # 每张新图片用新的值；重试同一个请求时沿用原来的值
        "X-Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "model": "nano-banana-2.1",
        "prompt": PROMPT,
        "resolution": "1K",
        "aspect_ratio": "1:1",
    },
    timeout=(10, 120),
)
response.raise_for_status()
creation = response.json()
print(creation["id"], creation["status"], creation["cost"])

// Node.js 22+，文件扩展名为 .mjs
import { randomUUID } from "node:crypto";

const API = "https://api.rendergrid.io/api/public/v1";
const prompt = "浅色书桌上摆着一本合上的亚麻封面笔记本、一支木铅笔和一只白瓷杯。镜头略微俯视，三个物件集中在画面中央，外侧留白均衡。左边窗光柔和，能看清封面织纹、木纹与陶瓷釉面。不出现文字、标志、人物或水印。";

const response = await fetch(`${API}/images/generate`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.RENDERGRID_API_KEY}`,
    "Content-Type": "application/json",
    // 每张新图片用新的值；重试同一个请求时沿用原来的值
    "X-Idempotency-Key": randomUUID(),
  },
  body: JSON.stringify({
    model: "nano-banana-2.1",
    prompt,
    resolution: "1K",
    aspect_ratio: "1:1",
  }),
  signal: AbortSignal.timeout(120_000),
});
if (response.status !== 202) {
  throw new Error(`HTTP ${response.status}: ${await response.text()}`);
}
const creation = await response.json();
console.log(creation.id, creation.status, creation.cost);

CREATION_ID="5b0214ae-9e39-460a-820a-f6ae3e24400b"  # 请求响应中的 id
curl --fail-with-body --max-time 20 \
  "https://api.rendergrid.io/api/public/v1/creations/$CREATION_ID" \
  -H "Authorization: Bearer $RENDERGRID_API_KEY"

import os
import time

import requests

API = "https://api.rendergrid.io/api/public/v1"
KEY = os.environ["RENDERGRID_API_KEY"]
HEADERS = {"Authorization": f"Bearer {KEY}"}
creation_id = "5b0214ae-9e39-460a-820a-f6ae3e24400b"  # 请求响应中的 id
MAX_WAIT = 180  # 秒：这是你自己设定的等待上限，不是服务承诺的时限

started = time.monotonic()
while True:
    r = requests.get(f"{API}/creations/{creation_id}", headers=HEADERS, timeout=(5, 20))
    r.raise_for_status()
    creation = r.json()
    if creation["status"] in ("completed", "failed"):
        break
    if time.monotonic() - started > MAX_WAIT:
        raise TimeoutError(f"{creation_id}：等待超时，请稍后再查询")
    time.sleep(5)  # 查询频率不能高于每 5 秒一次

if creation["status"] == "completed":
    print(creation["result_urls"])
else:
    print(creation["error"], creation["failure"])

// Node.js 22+，文件扩展名为 .mjs
const API = "https://api.rendergrid.io/api/public/v1";
const headers = { Authorization: `Bearer ${process.env.RENDERGRID_API_KEY}` };
const creationId = "5b0214ae-9e39-460a-820a-f6ae3e24400b"; // 请求响应中的 id
const MAX_WAIT_MS = 180_000; // 你自己设定的等待上限，不是服务承诺的时限
const pending = (status) => status === "queued" || status === "processing";

const started = Date.now();
let creation;
do {
  // 查询频率不能高于每 5 秒一次
  await new Promise((resolve) => setTimeout(resolve, 5000));
  const res = await fetch(`${API}/creations/${creationId}`, {
    headers,
    signal: AbortSignal.timeout(20_000),
  });
  if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
  creation = await res.json();
  if (pending(creation.status) && Date.now() - started > MAX_WAIT_MS) {
    throw new Error(`${creationId}：等待超时，请稍后再查询`);
  }
} while (pending(creation.status));

console.log(creation.status);
console.log(creation.result_urls ?? creation.error);