Nano Banana API

价格

费用 = 每张图片积分 × n。提交任务时预留积分；任务失败，或你在开始前取消，积分全额退回。

生成示例

该模型通过 API 生成的原图，未经修图。

• 

  lighthouse on a rocky coast at golden hour

速览

快速开始

在控制台创建密钥，然后提交任务并轮询。第二个请求里的 id 换成第一个请求返回的那个。

curl -s -X POST https://api.genmux.tech/v1/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"model":"nanobanana","prompt":"a red fox in fresh snow, low winter sun","n":1,"resolution":"1K","ratio":"1:1"}'

{
  "id": "0d8b6a3e-2f1c-4a5b-9c1d-7e2f3a4b5c6d",
  "model": "nanobanana",
  "status": "queued",
  "params": {"prompt": "a red fox in fresh snow, low winter sun", "n": 1, "resolution": "1K", "ratio": "1:1"},
  "cost": 2,
  "created_at": "2026-08-30T20:01:12.345Z"
}

curl -s https://api.genmux.tech/v1/generations/0d8b6a3e-2f1c-4a5b-9c1d-7e2f3a4b5c6d \
  -H "Authorization: Bearer $API_KEY"

{
  "id": "0d8b6a3e-2f1c-4a5b-9c1d-7e2f3a4b5c6d",
  "model": "nanobanana",
  "status": "succeeded",
  "cost": 2,
  "images": [
    {"index": 0, "url": "https://…/0.png?X-Amz-Expires=900&…", "expires_at": "2026-08-30T20:16:30Z", "mime": "image/png", "width": 1024, "height": 1024, "bytes": 1843201, "sha256": "9f2c…"}
  ],
  "created_at": "2026-08-30T20:01:12.345Z",
  "finished_at": "2026-08-30T20:01:19.802Z"
}

import os, time, uuid, requests

BASE = "https://api.genmux.tech"
auth = {"Authorization": f"Bearer {os.environ['API_KEY']}"}

job = requests.post(
    f"{BASE}/v1/generations",
    headers={**auth, "Idempotency-Key": str(uuid.uuid4())},
    json={"model": "nanobanana", "prompt": "a red fox in fresh snow, low winter sun", "n": 1, "resolution": "1K", "ratio": "1:1"},
    timeout=30,
).json()

while job["status"] in ("queued", "running"):
    time.sleep(1)
    job = requests.get(f"{BASE}/v1/generations/{job['id']}", headers=auth, timeout=30).json()

print(job["images"][0]["url"])  # presigned, valid for 15 minutes

const BASE = "https://api.genmux.tech";
const auth = { Authorization: `Bearer ${process.env.API_KEY}` };

let job = await fetch(`${BASE}/v1/generations`, {
  method: "POST",
  headers: { ...auth, "Idempotency-Key": crypto.randomUUID(), "Content-Type": "application/json" },
  body: JSON.stringify({ model: "nanobanana", prompt: "a red fox in fresh snow, low winter sun", n: 1, resolution: "1K", ratio: "1:1" }),
}).then((r) => r.json());

while (job.status === "queued" || job.status === "running") {
  await new Promise((r) => setTimeout(r, 1000));
  job = await fetch(`${BASE}/v1/generations/${job.id}`, { headers: auth }).then((r) => r.json());
}

console.log(job.images[0].url); // presigned, valid for 15 minutes

常见问题

Nano Banana API 是什么？

Nano Banana 是一个图像生成模型（capability image.generate），在 genmux API 上的模型标识是 "nanobanana"。你向 /v1/generations POST 一条提示词，立刻拿到任务 id，再从预签名 URL 取回成品图。它是目录里的通用选项：出图快，单张价格也是我们最低的。

一张 Nano Banana 图片多少钱？

每张 2 积分起，约合 $0.025，按「Scale」套餐单价计算。价格随分辨率变化：1K — 2 积分。请求 n 张就是单张价格的 n 倍。

支持哪些分辨率？

分辨率是档位而不是具体像素：这个模型可输出 1K，不传 resolution 字段时默认 1K。不在列表内的档位会以 400 validation_error 拒绝，而不是悄悄降采样。旧的 size 字段（"1024x1024"）为兼容已有接入仍可使用——会映射到最接近的档位和比例——但新代码请传 resolution 和 ratio。

可以指定哪些宽高比？

auto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 5:4, 4:5, 21:9。通过 ratio 字段传入，默认 1:1，"auto" 让模型自己挑选与提示词匹配的画幅。比例不影响价格，只有分辨率档位影响。

可以传参考图吗（图生图）？

可以。把 images 传成公开 https URL 的数组——每次请求最多 14 张——这时提示词描述的是你想要的修改或变体，而不是整个画面。有参考图时提示词可选。URL 必须能从公网访问；内网地址和非 https 的 URL 会以 400 validation_error 拒绝。

有反向提示词吗？

有。在 prompt 之外传 negative_prompt，用来描述画面里不想要的东西——瑕疵、文字、水印、想避开的颜色。不额外收费。

一次请求能生成多少张？

每次调用最多 4 张，通过 n 字段指定。每张单独计费，所以在 1K 下 n=4 就是单张价格的 4 倍。要出更大批量请提交多个任务——限制吞吐的是账户并发上限（默认 20 个在途任务），不是 n。

生成结果可复现吗？支持随机种子吗？

支持。在提示词之外传一个整数 seed，相同的种子配相同的提示词、分辨率和比例，就能得到可复现的结果。不传则每次独立采样。

一次生成要多久？

从提交到 succeeded 通常 1–20 秒，取决于尺寸和队列深度。这套 API 天生是异步的：POST /v1/generations 在毫秒级返回任务 id，之后你要么轮询 GET /v1/generations/{id}，要么让 webhook 在完成时通知你。

有 webhook 吗，还是必须轮询？

两种都行。创建任务时传 webhook_url（https，公网主机），完成时我们会 POST 一次，失败按退避重试最多 8 次，直到你的接口返回 2xx。每次投递都带 HMAC-SHA256 签名，用你的账户 webhook 密钥验证。轮询也没问题——读取任务的开销很低。

生成失败会怎样？

不会扣费。积分在任务创建时预留，若任务失败、在排队阶段被取消，或模型暂时不可用（503 model_unavailable），都会全额退回。失败的任务会带一个 error 对象，其中的 code（例如 content_policy）方便你分支处理。

积分是怎么算的？

积分是预付的，不会按月清零：买一次套餐，用多少扣多少，没有订阅。这个模型下一张 1K 图片消耗 2 积分；余额和完整流水可以在控制台以及 GET /v1/account 查看。

重试时怎么避免重复扣费？

每个 POST /v1/generations 都必须带 Idempotency-Key 请求头。用同一个 key 重发会以 200 返回原来的任务，不会再扣费，所以网络超时可以放心重试。用同一个 key 配不同的请求体会被 422 idempotency_key_mismatch 拒绝。

生成的图片能商用吗？

可以——根据我们的服务条款，我们能转让的权利归你所有，可用于商业用途，前提是提示词和用途符合条款以及上游模型供应商的内容政策。面向客户发布之前请先阅读条款。

图片 URL 有效期多久？

图片 URL 是预签名的，签发后 15 分钟过期。需要长期保存请把文件下载到你自己的存储；再次请求该任务会重新签发新的 URL。

以后想换模型怎么办？

改请求体里的 model 字段——调用的其他部分都不用变。模型 id 来自 GET /v1/models，它还会返回每个模型的分辨率档位、比例和价格，你可以在自己的界面里展示整个目录而无需重新部署。未知 id 会返回 404 model_not_found。

提示词有长度限制吗？

提示词长度为 1 到 2000 个字符。超长会以 400 validation_error 拒绝；整个请求体上限 64 KB。

延伸阅读

• genmux MCP 服务器：在 Claude、Cursor 和 OpenCode 里出图

  一条 npx 命令安装 @genmux/mcp，让 Claude、Cursor、OpenCode 或 Continue 列出模型、预估费用并生成 Nano Banana 图片。

  2026年9月7日

• Nano Banana 与 Nano Banana Pro：什么时候值得多花一倍

  两个 Nano Banana 模型的实用对比：画质、提示词还原、支持的分辨率、延迟和成本，并按使用场景给出具体建议。

  2026年8月30日

• 2026 年 Nano Banana API 价格：一张图多少钱

  Nano Banana API 按分辨率计的单张成本、积分计价是怎么回事，以及我们的价格与谷歌、kie.ai 等服务商的对比。

  2026年8月30日

其他模型

同一个密钥、同一种请求格式——改一下 model 字段就能切换。

• Nano Banana Pro API

  nanobanana-pro

  更高保真度的生成模型，适合主视觉和印刷尺寸的画面，支持 1K、2K 和 4K 输出——1K 档的单张价格约为基础版的两倍。

  每张 4 积分 ≈ $0.05 起

• Qwen-Image 2.0 API

  qwen-image-2

  阿里的 Qwen-Image 2.0——围绕画面内可读文字（包括中文）设计的图像模型，支持参考图输入，输出 1K 或 2K。

  每张 3 积分 ≈ $0.038 起

• Qwen-Image Max API

  qwen-image-max

  Qwen-Image Max——阿里 Qwen-Image 产品线的旗舰，支持参考图输入，输出 1K 和 2K，提供固定的五种宽高比。

  每张 8 积分 ≈ $0.10 起

• Seedream 5.0 API

  seedream-5

  字节跳动 Seedream 5.0——面向写实画面和画面内文字的高分辨率模型，仅提供 2K 和 4K。支持参考图，按张用积分计费。

  每张 16 积分 ≈ $0.20 起

• Wan 2.7 Image API

  wan-2-7-image

  阿里通义万相系列的 wan2.7-image——文生图与参考图生成，输出 1K 或 2K，与这里其他模型共用同一接口和 API 密钥。

  每张 2 积分 ≈ $0.025 起