厂商自己的 API 还是统一 API：什么时候直接用更好

01我们到底比较什么？

我们只比较价格；密钥、限额和支付方式，我们告诉你该向厂商核实什么。

• Rendergrid 按自己的文档写：价格、密钥、限额和支付方式，都照 Rendergrid 文档的说法描述。

• 官方价格只引用 Google 的：Google 的单张价格取自它自己的页面，OpenAI 的价格只给出链接；两家的密钥、限额和支付条件，我们不转述。

• 图片只来自 Rendergrid：三次请求都发给 Nano Banana 2.1，分辨率 1K，宽高比 1:1，各一次尝试。这些提示词没有直接发给过厂商。

• 不比速度和质量：三张图片不足以支撑这样的比较。

02一张图片多少钱？

在 Rendergrid，价格取决于模型和分辨率。Nano Banana 2.1 的 1K、2K、4K 价格分别是 $0.02、$0.03 和 $0.04；Nano Banana Pro 分别是 $0.04、$0.04 和 $0.07。金额在接收请求时扣除，请求失败则立即退回余额，详见这篇讲请求失败退款的文章。

下面两张表把 Google 的官方单张价格放在 Rendergrid 的价格旁边。表中是 Google 的标准价格，不含批量模式。

OpenAI 的官方价格因图片的尺寸和质量档位而异。要对照 OpenAI 的价格，先弄清它按哪个尺寸、哪个质量档位报价，官方页面见文末的来源。

各分辨率的价格，见 Nano Banana 2.1 API 的价格文章和 Nano Banana Pro API 的价格文章；所有模型的价格在价格页。

03Rendergrid 的密钥和限额是怎样的？

Rendergrid 的 API 密钥一个就能用于账号下的所有模型：它由前缀 rg_live_ 和另外 40 个字符组成。完整的密钥只在创建时显示一次，我们只保存它的指纹，所以丢失的密钥无法找回，只能新建。一个账号最多可以有 50 个有效密钥。

密钥本身没有单独的权限，也没有自己的请求速率。能为单个密钥设置的只有月度消费限额：这是硬性限制，用尽后，使用该密钥的新生成请求会收到 402。同样的月度限额也可以设在整个账号上。

请求速率的默认值对任何账号都一样，并由账号下的所有密钥共用：每分钟 120 次请求，队列中或处理中的任务共 100 个。同一个任务的状态，用同一个密钥查询时，每 5 秒最多一次。超出这些限制时，API 返回 429；增加密钥不会提高它们。如果不够用，请联系技术支持，因为具体账号的限额可能不同。怎样避开这些限制，见这篇讲错误 429 的文章。

04怎样为图片付款？

Rendergrid 的余额以美元计，只能用 USDT 充值：在控制台的“余额与充值”页面中充值，或通过经理充值。网络可选 Tron (TRC20)、BNB Chain (BEP20) 或 Solana (SOL)。金额由你选择，到账的正是这个金额：支付服务的手续费由我们承担，转账本身的网络手续费由你发送所用的钱包支付。支付窗口有时限；大额充值还会在余额上加一笔奖励，条件见“USDT 充值”页面。没有订阅，资金只花在成功生成的图片上。

如果你需要 USDT 以外的支付方式，Rendergrid 满足不了：充值只能用 USDT，在控制台的“余额与充值”页面中充值，或通过经理充值。请到厂商的页面上核实它支持哪些支付方式。

05请求和结果长什么样？

向 Rendergrid 发请求的方式对所有模型都一样：POST /images/generate，字段是 model、prompt、resolution 和 aspect_ratio。要换模型，把 model 换成另一个即可，前提是新模型支持同样的分辨率和宽高比，否则请求会在扣费前返回 400。下面是第一张图片的请求。

# 需要 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

key = os.environ["RENDERGRID_API_KEY"]
payload = {
    "model": "nano-banana-2.1",
    "prompt": "象牙白无缝背景上放一只绿色陶瓷杯，杯把朝右。镜头接近杯口高度，略带角度。左侧柔光与短阴影衬出釉面轻微起伏。杯子完整居中，周围空间宽松。不出现文字、标志、人物或水印。",
    "resolution": "1K",
    "aspect_ratio": "1:1",
}
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 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.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.02
}

{
  "id": "5b0214ae-9e39-460a-820a-f6ae3e24400b",
  "status": "completed",
  "result_urls": [
    "https://…"
  ]
}

202 表示“已接收”，而不是“已完成”；cost 是为这张图片扣除的美元金额。完成后，GET /creations/{id} 会在 result_urls 字段里返回结果：文件只保存一天，请及时存到自己的存储中。全部步骤见快速开始，以及 Nano Banana 2.1 API 的快速开始文章和 Nano Banana Pro API 的快速开始文章。

下面三张图片是三次请求的结果，都是通过 Rendergrid 发给 Nano Banana 2.1 的：一只杯子、一套餐具，以及换了背景的杯子。三次请求没有带参考图，所以每张图里的杯子各不相同。

第一个请求的提示词

象牙白无缝背景上放一只绿色陶瓷杯，杯把朝右。镜头接近杯口高度，略带角度。左侧柔光与短阴影衬出釉面轻微起伏。杯子完整居中，周围空间宽松。不出现文字、标志、人物或水印。

1K · 1:1 · 一次尝试复制提示词

第二个请求的提示词

绿色陶瓷杯、碗、盘组成一套，放在象牙白无缝背景上。盘子平放后方，碗在左，杯在右，尽量少重叠。左侧柔光照出一致釉色。整套完整入镜，四周留宽边距。不出现文字、标志、人物或水印。

1K · 1:1 · 一次尝试复制提示词

第三个请求的提示词

淡陶土色背景上是一只绿色陶瓷杯，杯把朝右。机位接近杯口高度，柔光来自左侧。一片叶影落在旁边空地，不穿过杯子。产品完整，构图安静宽松。不出现文字、标志、人物或水印。

1K · 1:1 · 一次尝试复制提示词

06什么时候直接用厂商的 API 更好？

统一 API 是你和厂商之间多出来的一环，有它自己的规则。下面几条里只要有一条对你很重要，就值得直接去看厂商的 API：

• 支付方式：Rendergrid 的余额只能用 USDT 充值，在控制台的“余额与充值”页面中充值，或通过经理充值。如果你需要别的支付方式，请到厂商的页面上核实它支持哪些。
• Rendergrid 里没有的模型或参数：通过 Rendergrid 能用的是它模型目录里的模型，你的账号可用哪些，由 GET /models 返回。请求里没有蒙版：要编辑图片，就把原图作为参考图传入，并在提示词里写明改动。width 和 height 也不接受，尺寸由 resolution 和 aspect_ratio 决定。你需要的如果不止这些，请到厂商那里找。
• 合同约束的服务保证：Rendergrid 没有服务等级协议（SLA）。如果你需要，请向厂商了解它的条款。
• 高于默认值的限额：Rendergrid 的默认值是每分钟 120 次请求、100 个任务。账号的限额可以和技术支持商量，也可以去核对厂商的限额。
• 少一层中转：你的提示词和图片会经过 Rendergrid。参考图在最后一次上传后保存 48 小时，结果文件保存一天；我们不会把你的提示词和图片用于训练模型。

07什么时候选统一 API 更合适？

• 多个模型，一个入口：一个 API 密钥、一个余额，用于目录里 Google 和 OpenAI 的模型；请求和响应的格式相同，用 model 字段选择模型。
• 花费看得见：余额以美元计，GET /models 返回你的账号的单张价格，202 响应里的 cost 字段是这次请求扣除的金额。月度消费限额可以设在单个密钥上，也可以设在整个账号上。
• 请求失败不会扣费：金额在接收请求时扣除，没有生成出图片就会立即退回余额。
• 安全地重试，也可以不轮询：请求头 X-Idempotency-Key 用来避免重复扣费：用同一个键重试，会返回相同的 202 响应，不会有新的扣费。想不轮询，可以接收带 HMAC-SHA256 签名的 creation.completed 或 creation.failed 事件。
• 每个集成一个密钥：一个账号最多 50 个密钥，可以分别撤销；余额和请求速率限制由整个账号共用。

08该向厂商问什么？

Google 和 OpenAI 的条款我们不转述。下面是值得你向厂商核实的问题：

1. 密钥怎么发放？能不能限制花费？
2. 你的账号有哪些限额？怎样提高？
3. 支持哪些支付方式和币种？
4. 什么时候扣费？没有生成出图片时会不会退款？
5. 生成好的图片保存多久？厂商怎样处理你的提示词？
6. 有没有服务等级协议？

09这个对比哪里不适用？

• 三张图片不是模型对比：这是三次发给 Nano Banana 2.1 的请求，各一次尝试，不能据此判断质量或速度。
• 没有直接运行过：这些提示词没有发给过厂商自己的 API，所以不知道直接使用时结果有何不同。
• 厂商的条款不在这里：Google 和 OpenAI 的密钥、限额和支付条件，我们不转述，请直接读厂商的页面。
• 价格对照表只覆盖两款 Nano Banana：OpenAI 模型的价格，请看价格页和 OpenAI 自己的页面。
• 价格不是永远不变：价格按核对时的数据给出，Rendergrid 至少每周与官方页面核对一次。

10常见问题解答

11来源

1. Google AI for Developers：价格页Google 的官方单张价格：标准价格，不含批量模式。
2. OpenAI：API 价格OpenAI 的官方价格。
3. OpenAI：图像生成与费用OpenAI 按图片计价的表格和价格计算器。
4. Rendergrid 价格每款模型、每种分辨率的单张价格。
5. Rendergrid 文档：密钥与鉴权API 密钥的格式和数量。
6. Rendergrid 文档：限额请求速率和月度消费限额。
7. Rendergrid 文档：USDT 充值网络、手续费和支付窗口。
8. Rendergrid 文档：余额何时扣费，请求失败如何退回。
9. Rendergrid 文档：模型与参数模型目录、分辨率和宽高比。
10. Rendergrid 使用条款结果保存期限，没有服务等级协议。
11. Rendergrid 隐私政策数据保存期限，不用于训练模型。