Nano Banana 2 文生图
SpiderHubs OpenAPI 文档：Nano Banana 2 文生图，分类 Nano Banana 2。接口 POST /openapi/v1/image/nano-banana-2。✅ 实测各线路均支持 size / ratio (2026-05-27)。返回的实际像素 W×H 由模型决定，约等于...
OpId:
img-nano-banana-2 · 最近更新: 2026-05-271. 接口概览
| 项 | 值 |
|---|---|
| 底层模型 | gemini-3.1-flash-image-preview |
| 计费 | 1.5 积分 / 次 |
| 限流 | 30 次 / 分钟 / 用户 |
| 响应协议 | OpenAI images/generations 标准（{data:[{b64_json}], created}） |
| 延迟 | 通常 15 ~ 30s |
2. 基础信息
- Endpoint:
- POST /openapi/v1/image/nano-banana-2
3. 请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| prompt | string | 是 | 图片描述提示词 |
| size | string | 否 | 分辨率档，可选 1K / 2K / 4K，默认 2K；也兼容直接传 WxH（如 1024x1024）。 |
| ratio | string | 否 | 长宽比，可选 1:1 / 16:9 / 9:16 / 4:3 / 3:4，默认 1:1。 |
| route | int | 否 | 生图线路 1/2，默认 1。不同线路对应不同算力供应商，可在效果/速度/稳定性间切换；同一 prompt 不同 route 风格可能有差异。 |
size × ratio 映射表
✅ 实测各线路均支持
size / ratio (2026-05-27)。返回的实际像素 W×H 由模型决定，约等于上表理论值 (1K/4K 档可能略小)。| 1:1 | 16:9 | 9:16 | 4:3 | 3:4 | |
|---|---|---|---|---|---|
| 1K | 1280×1280 | 1280×720 | 720×1280 | 1280×960 | 960×1280 |
| 2K | 2048×2048 | 2048×1152 | 1152×2048 | 2048×1536 | 1536×2048 |
| 4K | 2880×2880 | 3840×2160 | 2160×3840 | 3216×2560 | 2560×3216 |
4. 响应
响应是标准 OpenAI
字段说明：
·
·
·
Python 解码示例：
/v1/images/generations 结构：{ "created": <epoch>, "data": [ { "b64_json": "<base64>" } ] }字段说明：
·
created：服务端时间戳（秒）。·
data[i].b64_json：图片字节的 base64 编码。·
data 数组当前固定 1 个元素（单图返回）。Python 解码示例：
import base64
b = base64.b64decode(res["data"][0]["b64_json"])
open("out.jpg","wb").write(b)请求示例 · cURL
curl -X POST 'https://api.spiderhubs.com/openapi/v1/image/nano-banana-2' \
-H 'Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxx' \
-H 'Content-Type: application/json' \
-d '{
"prompt": "a cat riding a skateboard, neon colors",
"size": "2K",
"ratio": "16:9",
"route": 1
}'响应示例
{
"created": 1716345678,
"data": [
{ "b64_json": "/9j/4AAQSkZJRgABAQEBLAEsAAD/..." }
]
}开始调用 SpiderHubs API
使用账户中心生成的 API Key，通过 Authorization: Bearer sk_live_xxx 调用接口。