Nano Banana Pro 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-pro",
    "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-pro",
        "prompt": PROMPT,
        "resolution": "1K",
        "aspect_ratio": "1:1",
    },
    timeout=(10, 120),
)
response.raise_for_status()
creation = response.json()  # 202：{id, status, task_id, cost}
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-pro",
    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()}`);
}
// 202 响应：{id, status, task_id, cost}
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"

# 每隔 5 秒以上再查一次，直到 status 变成 completed 或 failed。
# 然后用 result_urls 里的第一个链接保存文件：
RESULT_URL="https://…"
curl --fail-with-body --max-time 60 -L -o result-1k "$RESULT_URL"

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

# 等待上限是示例自己的设置，不是模型的处理时长
deadline = time.monotonic() + 180
while True:
    if time.monotonic() >= deadline:
        raise SystemExit(f"还没有结果，请保存 id：{creation_id}")
    time.sleep(5)  # 查询频率不能高于每 5 秒一次
    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 creation["status"] == "failed":
    raise SystemExit(f"{creation['error']} {creation['failure']}")

image = requests.get(creation["result_urls"][0], timeout=(10, 60))
image.raise_for_status()
print(image.headers.get("Content-Type"))  # 文件格式以它为准
with open("result-1k", "wb") as file:
    file.write(image.content)

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

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 deadline = Date.now() + 180_000;
let creation;
do {
  if (Date.now() >= deadline) {
    throw new Error(`还没有结果，请保存 id：${creationId}`);
  }
  // 查询频率不能高于每 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();
} while (["queued", "processing"].includes(creation.status));

if (creation.status === "failed") {
  throw new Error(`${creation.error} ${JSON.stringify(creation.failure)}`);
}

const image = await fetch(creation.result_urls[0], { signal: AbortSignal.timeout(60_000) });
if (!image.ok) throw new Error(`HTTP ${image.status}`);
console.log(image.headers.get("content-type")); // 文件格式以它为准
await writeFile("result-1k", Buffer.from(await image.arrayBuffer()));