429 错误与限额：怎样生成才不被限流

# 需要 bash、curl 和 uuidgen。每个操作只创建一次幂等键。
IDEMPOTENCY_KEY="$(uuidgen)" || exit 1
curl -i --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"
  }'

# 如果返回 429，先读取 Retry-After 响应头，等待之后
# 再用同一个 $IDEMPOTENCY_KEY 重新发送这条完全相同的请求

import os
import random
import time
import uuid

import requests

API = "https://api.rendergrid.io/api/public/v1"


def submit_with_backoff(payload, idempotency_key, max_attempts=5):
    key = os.environ["RENDERGRID_API_KEY"]
    headers = {
        "Authorization": f"Bearer {key}",
        # 所有尝试都使用同一个键
        "X-Idempotency-Key": idempotency_key,
    }
    for attempt in range(max_attempts):
        response = requests.post(
            f"{API}/images/generate",
            headers=headers, json=payload, timeout=(10, 120),
        )
        if response.status_code != 429:
            return response
        try:
            body = response.json()
        except ValueError:
            body = {}
        details = body.get("error", {}).get("details", {})
        last = attempt + 1 == max_attempts
        if details.get("reason") == "burst_block" or last:
            # 临时限制和最后一次尝试交给你的代码处理
            return response
        wait = int(response.headers.get("Retry-After", "2"))
        # 等待时间不短于 Retry-After
        time.sleep(max(0, wait) + random.uniform(0, 1))


payload = {
    "model": "nano-banana-2.1",
    "prompt": "浅灰背景上，五个木方块排成笔直的一行",
    "resolution": "1K",
    "aspect_ratio": "1:1",
}
response = submit_with_backoff(payload, str(uuid.uuid4()))
print(response.status_code, response.text)

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

const API = "https://api.rendergrid.io/api/public/v1";
const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

async function submitWithBackoff(payload, idempotencyKey, maxAttempts = 5) {
  for (let attempt = 0; attempt < maxAttempts; attempt++) {
    const response = await fetch(`${API}/images/generate`, {
      method: "POST",
      headers: {
        Authorization: `Bearer ${process.env.RENDERGRID_API_KEY}`,
        "Content-Type": "application/json",
        // 所有尝试都使用同一个键
        "X-Idempotency-Key": idempotencyKey,
      },
      body: JSON.stringify(payload),
      signal: AbortSignal.timeout(120_000),
    });
    if (response.status !== 429) return response;
    const body = await response.clone().json().catch(() => ({}));
    const last = attempt + 1 === maxAttempts;
    if (body.error?.details?.reason === "burst_block" || last) {
      // 临时限制和最后一次尝试交给你的代码处理
      return response;
    }
    const wait = Number(response.headers.get("Retry-After") ?? 2);
    const delay = Math.max(0, wait);
    // 等待时间不短于 Retry-After
    await sleep((delay + Math.random()) * 1000);
  }
}

const response = await submitWithBackoff(
  {
    model: "nano-banana-2.1",
    prompt: "浅灰背景上，五个木方块排成笔直的一行",
    resolution: "1K",
    aspect_ratio: "1:1",
  },
  randomUUID(),
);
console.log(response.status, await response.text());