OpenAPI 文档/Nano Banana ProPOST

Nano Banana Pro 文生图

SpiderHubs OpenAPI 文档:Nano Banana Pro 文生图,分类 Nano Banana Pro。接口 POST /openapi/v1/image/nano-banana-pro/t2i。📐 完整 size × ratio → W×H 映射表与实测说明,统一维护在左侧导航的 「Na...

OpId: img-nano-banana-pro-t2i · 最近更新: 2026-05-24

1. 接口概览

底层模型gemini-3-pro-image-preview
计费2 积分 / 次
限流20 次 / 分钟 / 用户
特性高品质、更强语义理解;与图改图同模型不同端点

2. 基础信息

Endpoint:
POST /openapi/v1/image/nano-banana-pro/t2i

3. 请求参数

参数类型必填说明
promptstring图片描述提示词
sizestring分辨率档,可选 1K / 2K / 4K,默认 2K;也兼容直接传 WxH(如 1024x1024)。
ratiostring长宽比,可选 1:1 / 16:9 / 9:16 / 4:3 / 3:4,默认 1:1。
routeint生图线路 1/2,默认 1。不同线路对应不同算力供应商,可在效果/速度/稳定性间切换;同一 prompt 不同 route 风格可能有差异。

size × ratio 映射表

📐 完整 size × ratio → W×H 映射表与实测说明,统一维护在左侧导航的 「Nano Banana 2 文生图」 页面。本端点的 size/ratio 行为与之一致,如表有更新,所有图片端点同步生效。

4. 响应

响应是标准 OpenAI /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-pro/t2i' \
  -H 'Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt": "ultra-detailed cyberpunk street, rainy night, neon reflections",
    "size": "2K",
    "ratio": "16:9",
    "route": 1
  }'
响应示例
{
  "created": 1716345678,
  "data": [
    { "b64_json": "/9j/4AAQSkZJRgABAQEBLAEsAAD/..." }
  ]
}

开始调用 SpiderHubs API

使用账户中心生成的 API Key,通过 Authorization: Bearer sk_live_xxx 调用接口。