API 文档：快速开始

$ export RENDERGRID_API_KEY="rg_live_your_key"

# 需要 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": "4:5"
  }'

import os
import uuid
import requests

key = os.environ["RENDERGRID_API_KEY"]
payload = {
    "model": "nano-banana-pro",
    "prompt": "大理石上的陶瓷杯，柔和的窗光",
    "resolution": "1K",
    "aspect_ratio": "4:5",
}
response = requests.post(
    "https://api.rendergrid.io/api/public/v1/images/generate",
    headers={
        "Authorization": f"Bearer {key}",
        # 每个请求使用新的值；重试时使用同一个值
        "X-Idempotency-Key": str(uuid.uuid4()),
    },
    json=payload,
    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 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: "4:5",
  }),
  signal: AbortSignal.timeout(120_000),
});
if (!response.ok) {
  const body = await response.text();
  throw new Error(`HTTP ${response.status}: ${body}`);
}
const creation = await response.json();
console.log(creation.id, creation.status, creation.cost);

{
  "id": "5b0214ae-9e39-460a-820a-f6ae3e24400b",
  "status": "queued",
  "task_id": "5b0214ae-9e39-460a-820a-f6ae3e24400b",
  "cost": 0.04
}

CREATION_ID="5b0214ae-9e39-460a-820a-f6ae3e24400b"  # 第 2 步中的 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"  # 第 2 步中的 id

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
    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 key = process.env.RENDERGRID_API_KEY;
const headers = { Authorization: `Bearer ${key}` };
// 第 2 步中的 id
const creationId = "5b0214ae-9e39-460a-820a-f6ae3e24400b";

let creation;
do {
  // 查询频率不能高于每 5 秒一次
  await new Promise((resolve) => setTimeout(resolve, 5000));
  const url = `${API}/creations/${creationId}`;
  const res = await fetch(url, { headers });
  if (!res.ok) {
    throw new Error(`HTTP ${res.status}: ${await res.text()}`);
  }
  creation = await res.json();
} while (["queued", "processing"].includes(creation.status));

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

{
  "id": "5b0214ae-9e39-460a-820a-f6ae3e24400b",
  "status": "completed",
  "result_urls": ["https://cdn.rendergrid.io/images/example/result.jpg"]
}

$ curl -L -o result.jpg \
    "https://cdn.rendergrid.io/images/example/result.jpg"