生图per_image

NanoBanana Pro 2K/4K

nanobanana-pro-2k-4k

Nano Banana 2 旗舰画质（2K / 4K），电影级光影与商业级设计。。通过小乖 API 以统一的 Bearer Key 异步调用，支持参数化尺寸与可选参考图（视模型而定）。按人民币余额扣费，失败自动退款。模型 ID：nanobanana-pro-2k-4k。

API 文档 →获取 API Key 全部定价

售价 // PRICE

¥0.12 起/张

2K¥0.12/张
4K¥0.12/张

按 resolution（或 quality）分档计费；视频再乘 duration。提交任务时冻结，成功结算；失败/超时自动退款。

▸ 异步任务

▸ 失败自动退款

▸ 参考图可选

▸ 人民币按次计价

▸ 统一 API Key

▸ 多模型一套接口

ONLINE PLAYGROUND

登录后可直接生成，费用从账户余额扣除。

登录并试用

参数说明 // PARAMETERS

必填：model、prompt。标记为必填的素材字段也必须提供；提交时未知字段会被拒绝。

参数	说明	取值
resolution	分辨率影响清晰度与计费（部分模型按更高分辨率计价）。	可选：2k / 4k
aspect_ratio	画面比例横屏 / 竖屏 / 方形。	可选：16:9 / 9:16 / 1:1 / 4:3 / 3:4
image_urls	参考图 URL 可选参考图，支持 https URL 或 base64 Data URI。	image URL 数组，最多 14 个

快速接入 // QUICKSTART

cURL

curl -X POST https://xiaoguai123.xyz/api/v1/images/generations \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{ "model": "nanobanana-pro-2k-4k", "prompt": "霓虹灯下的一只白猫，雨夜街道，电影感", "resolution": "2k"}'

# → { "code":200, "data":[{ "status":"submitted", "task_id":"xg_..." }] }
# 再轮询 GET https://xiaoguai123.xyz/api/v1/tasks/{task_id}

Python

import requests, time

BASE = "https://xiaoguai123.xyz"
KEY = "sk-你的Key"
H = {"Authorization": f"Bearer {KEY}"}
payload = {
  "model": "nanobanana-pro-2k-4k",
  "prompt": "霓虹灯下的一只白猫，雨夜街道，电影感",
  "resolution": "2k"
}

r = requests.post(f"{BASE}/api/v1/images/generations", headers={**H, "Content-Type": "application/json"}, json=payload)
r.raise_for_status()
task_id = r.json()["data"][0]["task_id"]
print("task:", task_id)

while True:
    t = requests.get(f"{BASE}/api/v1/tasks/{task_id}", headers=H).json()["data"]
    print(t["status"], t.get("progress"))
    if t["status"] in ("completed", "failed"):
        print(t)
        break
    time.sleep(3)

适用场景 // USE CASES

电商与主图

批量出产品图、场景图，统一风格与尺寸。

UI / 原型

快速生成界面示意、海报与运营物料。

广告创意

多提示词并行试创意，按次计费不浪费。

内容本地化

多语言文字渲染场景（视模型能力）快速适配市场。

常见问题 // FAQ

Q. 如何调用 NanoBanana Pro 2K/4K？

在控制台创建 API Key，向 POST /api/v1/images/generations 提交，model 填 nanobanana-pro-2k-4k，再轮询 GET /api/v1/tasks/{task_id} 获取结果。

Q. 怎么计费？失败会扣钱吗？

本模型按张计费。提交时先冻结金额，成功结算；失败或超时会自动解冻退回，不会吞余额。

Q. 和官方 API 有什么区别？

你使用小乖签发的 Key，人民币余额按任务扣费；上游 Key 由平台持有。接口形态对齐常见异步生图/生视频流程，方便接入。

Q. 支持参考图吗？

若参数表含 image_urls，即可传入参考图 URL 或 Data URI（上限见参数说明）。