生图per_image
Nano Banana Pro
gemini-3-pro-image-preview
Gemini 3 Pro；按分辨率分档。通过小乖 API 以统一的 Bearer Key 异步调用，支持参数化尺寸与可选参考图（视模型而定）。按人民币余额扣费，失败自动退款。模型 ID：gemini-3-pro-image-preview。
售价 // PRICE
¥0.36/张
人民币余额扣费。提交任务时冻结，成功结算；失败/超时自动退款。实际金额以任务结算为准。
▸ 异步任务
▸ 失败自动退款
▸ 参考图可选
▸ 人民币按次计价
▸ 统一 API Key
▸ 多模型一套接口
参数说明 // PARAMETERS
必填：model、prompt。下列为可选参数（提交时未知字段会被拒绝）。
| 参数 | 说明 | 取值 |
|---|---|---|
| size | 尺寸 / 比例 控制输出画幅比例或像素尺寸。 | 可选：auto / 1:1 / 3:2 / 2:3 / 4:3 / 3:4 / 5:4 / 4:5 / 16:9 / 9:16 / 2:1 / 1:2 / 3:1 / 1:3 / 21:9 / 9:21 |
| n | 生成数量 单次请求生成张数。 | 整数 1–1，默认 1 |
| image_urls | 参考图 URL 可选参考图，支持 https URL 或 base64 Data URI。 | URL 数组，最多 14 个 |
| resolution | 分辨率 影响清晰度与计费（部分模型按更高分辨率计价）。 | 可选：1K / 2K / 4K |
快速接入 // QUICKSTART
cURL
curl -X POST https://xiaoguai123.xyz/api/v1/images/generations \
-H "Authorization: Bearer cr_你的Key" \
-H "Content-Type: application/json" \
-d '{ "model": "gemini-3-pro-image-preview", "prompt": "霓虹灯下的一只白猫，雨夜街道，电影感", "size": "1:1", "resolution": "1K"}'
# → { "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 = "cr_你的Key"
H = {"Authorization": f"Bearer {KEY}"}
payload = {
"model": "gemini-3-pro-image-preview",
"prompt": "霓虹灯下的一只白猫，雨夜街道，电影感",
"size": "1:1",
"resolution": "1K"
}
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. 如何调用 Nano Banana Pro？
在控制台创建 API Key，向 POST /api/v1/images/generations 提交，model 填 `gemini-3-pro-image-preview`，再轮询 GET /api/v1/tasks/{task_id} 获取结果。
Q. 怎么计费？失败会扣钱吗？
本模型按张计费。提交时先冻结金额，成功结算；失败或超时会自动解冻退回，不会吞余额。
Q. 和官方 API 有什么区别？
你使用小乖签发的 Key，人民币余额按任务扣费；上游 Key 由平台持有。接口形态对齐常见异步生图/生视频流程，方便接入。
Q. 支持参考图吗？
若参数表含 image_urls，即可传入参考图 URL 或 Data URI（上限见参数说明）。