Nano Banana API
Nano Banana 是 Google 对 Gemini 原生图像生成与编辑模型的称呼。在 Wizzx 上按价格、输出分辨率和速度比较已发布的各个版本，用同一个 API Key 调用。
- 可用版本
- 4
- 起步价
- $0.024/张
- 低于官方价
- 最多 52%
新账户赠送 $0.20 免费积分。
Nano Banana 系列模型由 Google 开发。Wizzx 提供 API 访问，不拥有这些模型。所有商标归各自所有者所有。
比较 Nano Banana API 各版本
| 版本 | 适合 | Wizzx 起步价 | 官方起步价 | 模型 ID |
|---|---|---|---|---|
| Nano Banana API (Gemini 2.5 Flash Image) | 面向高频创作流程的快速图像生成与对话式编辑模型，适合迅速出图、修改和扩展视觉方案。 | $0.024/张 | nano-banana | |
| Nano Banana Pro API 1K2K4K | Gemini 3 Pro Image：擅长文字密集的版式和多参考图编辑，一个提示词即可输出 1K、2K 或 4K 图像。 | $0.108/张 | nano-banana-pro | |
| Nano Banana 2 API (Gemini 3.1 Flash Image) 1K2K4K | 高效率图像生成与编辑模型，强化迭代速度、文字准确性，并支持 1K、2K 和 4K 输出。 | $0.048/张 | nano-banana-2 | |
| Nano Banana 2 Lite API | 面向高频交互工作流的超低延迟、低成本图像生成与编辑模型。 | $0.024/张 | nano-banana-2-lite |
Wizzx 价格为各版本最低档位，实时读取自价格目录。官方价格为模型厂商公开的可比档位标价（如有）。分辨率、时长和音频会影响档位，完整档位请看各版本页。
Nano Banana 各版本能力对比
各版本在 Wizzx 上接受的输入和输出选项，来自请求 schema。
| 版本 | Nano Banana | Nano Banana Pro | Nano Banana 2 |
|---|---|---|---|
| 参考素材 | 最多 10 个, 可选 | 最多 8 个, 可选 | 最多 14 个, 可选 |
| 分辨率 | — | 1K · 2K · 4K | 1K · 2K · 4K |
| 宽高比 | 1:1 · 3:2 · 2:3 · 4:3 · 3:4 · 16:9 · 9:16 · 21:9 · 5:4 · 4:5 · auto | 1:1 · 2:3 · 3:2 · 3:4 · 4:3 · 4:5 · 5:4 · 9:16 · 16:9 · 21:9 · auto | auto · 1:1 · 1:4 · 1:8 · 2:3 · 3:2 · 3:4 · 4:1 · 4:3 · 4:5 · 5:4 · 8:1 · 9:16 · 16:9 · 21:9 |
| 输出格式 | — | png · jpg | png · jpg |
该选哪个 Nano Banana 版本？
接入 Nano Banana API
创建服务端 API Key，按照所选模型的参数提交任务，保留返回的任务 ID 并查询结果。每个模型页都提供对应的请求协议文档。
- 1
创建 API Key
登录后在控制台创建密钥，在服务端环境中设置 WIZZX_API_KEY，不要将密钥暴露在浏览器代码中。
- 2
提交任务
向模型接口发送 POST 请求。提交成功后返回 data.task_id，请保留该 ID 用于查询。提交成功不代表内容已经生成完成。
- 3
获取生成结果
将 YOUR_TASK_ID 替换为返回的任务 ID，查询 /api/v1/task/status。等待 SUCCEEDED 后读取输出 URL。遇到 FAILED 或 REVIEW_REQUIRED 时停止，不要自动重提状态不明的任务。
提交 Nano Banana 任务
curl -X POST \
https://api.wizzx.ai/api/v1/task/submit/nano-banana \
-H "Authorization: Bearer $WIZZX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"aspect_ratio": "1:1",
"prompt": "木桌上的一只陶瓷咖啡杯，柔和的晨光，产品摄影"
}'const response = await fetch("https://api.wizzx.ai/api/v1/task/submit/nano-banana", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.WIZZX_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"aspect_ratio": "1:1",
"prompt": "木桌上的一只陶瓷咖啡杯，柔和的晨光，产品摄影"
}),
});
const payload = await response.json();
const task = payload.data ?? payload;
const taskId = task.task_id;import os
import requests
response = requests.post(
"https://api.wizzx.ai/api/v1/task/submit/nano-banana",
headers={
"Authorization": f"Bearer {os.environ['WIZZX_API_KEY']}",
},
json={
"aspect_ratio": "1:1",
"prompt": "木桌上的一只陶瓷咖啡杯，柔和的晨光，产品摄影"
},
)
payload = response.json()
task = payload.get("data", payload)
task_id = task["task_id"]curl -X POST \
https://api.wizzx.ai/api/v1/task/status \
-H "Authorization: Bearer $WIZZX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"task_id": "YOUR_TASK_ID"
}'const response = await fetch("https://api.wizzx.ai/api/v1/task/status", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.WIZZX_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ task_id: "YOUR_TASK_ID" }),
});
const payload = await response.json();
const task = payload.data ?? payload;import os
import requests
response = requests.post(
"https://api.wizzx.ai/api/v1/task/status",
headers={
"Authorization": f"Bearer {os.environ['WIZZX_API_KEY']}",
},
json={"task_id": "YOUR_TASK_ID"},
)
payload = response.json()
task = payload.get("data", payload)API 接入常见问题
- 这是官方的 Nano Banana API 吗？
- 不是。Nano Banana 模型由 Google 开发。Wizzx 是独立的 API 平台，通过一个 API Key、异步任务接口和按量计费的积分提供调用。
- Nano Banana API 的模型 ID 是什么？
- 向 POST /api/v1/task/submit/{model_id} 提交任务，可用的模型 ID：nano-banana, nano-banana-pro, nano-banana-2, nano-banana-2-lite。
- 任务失败会扣费吗？
- 不会。提交任务时预留积分，任务失败会退还，只有成功的任务才计费。
- 可以免费试用 Nano Banana API 吗？
- 可以。新账户赠送 $0.20 免费积分，用最便宜的 Nano Banana 约可生成 8 张图。
Wizzx API
开始使用 Nano Banana API
新账户赠送 $0.20 免费积分。按量付费，无需订阅，失败任务自动退款。