用 poloapi 中转调用 NanoBananaPro 生图：一份实战笔记
适合人群：
✔ 用过 OpenAI API
✔ 知道什么是文生图
✔ 只想把图“稳定地生成出来”
如果你只是想快速用 NanoBananaPro 生图，而不是研究模型原理，这篇就够了。
先把话说清楚（很重要）
poloapi.top = API 中转站（relay / proxy）
它不做这些事：
- ❌ 不训练模型
- ❌ 不优化生成效果
- ❌ 不改你的 prompt
它只做一件事：
把你的请求，原样转发给上游模型（NanoBananaPro），再把结果原样返回
所以：
效果 = 模型本身 + 你的 prompt
和 poloapi 本身没有“玄学关系”。
一、为什么要用 poloapi？
如果你已经能直连官方，那你其实不一定需要 poloapi。
但在这些情况下，它很有用：
- 官方接口访问不稳定
- 你想统一管理多个模型（不只一个 Key）
- 你已经有一套 OpenAI 兼容代码，不想重写
👉 poloapi 的最大价值：OpenAI 接口兼容
二、核心原理（30 秒看懂）
如果你之前用的是：
https://api.openai.com/v1/...
那现在你只是换成：
https://poloapi.top/v1/...
然后：
- Authorization：换成 poloapi 的 Key
- model：换成 NanoBananaPro 对应的名字
就这么简单。
三、最小可用生图请求（curl）
这是我最推荐的测试方式，先用 curl 验证，再写代码。
curl https://poloapi.top/v1/images/generations \-H "Authorization: Bearer YOUR_POLOAPI_KEY" \-H "Content-Type: application/json" \-d '{"model": "nanobanana-pro","prompt": "一只坐在咖啡馆里的橘猫，日系插画风，柔和光线","size": "1024x1024","n": 1}'
如果这一步能成功：
- 说明 Key ✔
- 说明模型名 ✔
- 说明你账号权限 ✔
后面写什么语言都只是“语法问题”。
四、返回结果你真正要用的是什么？
返回 JSON 里字段可能不少，但99% 的时候你只关心一个东西：
data[0].url
这就是生成好的图片。
你可以：
- 直接浏览器打开
- 前端 img 标签展示
- 后端下载存储
不用解码，不用管 CDN，不用问“能不能商用”这种玄学问题。
五、Python 示例（贴了就能跑）
import requestsurl = "https://poloapi.top/v1/images/generations"
headers = {"Authorization": "Bearer YOUR_POLOAPI_KEY","Content-Type": "application/json"
}payload = {"model": "nanobanana-pro","prompt": "赛博朋克风格的未来街道，夜晚，霓虹灯，电影感","size": "1024x1024","n": 1
}resp = requests.post(url, headers=headers, json=payload)
print(resp.json()["data"][0]["url"])
如果你之前用过 OpenAI：
👉 这段代码你甚至不用看文档就能写出来
六、NanoBananaPro 的 prompt 使用经验
不吹效果，只说结论：
✅ 它更吃「画面描述」
比起抽象风格词，更建议你写：
- 场景（室内 / 室外 / 夜晚 / 雨天）
- 主体（人物 / 动物 / 物体）
- 镜头（特写 / 中景 / 远景）
- 光线（柔光 / 逆光 / 高对比）
例子（实测稳定）：
夜晚的东京街头，下雨，霓虹灯反射在地面上，中景视角，电影感，高细节
七、最容易踩的 4 个坑
1️⃣ model 名写错
poloapi 不会帮你纠错，写错直接 4xx
2️⃣ 用了 chat/completions 生图
❌ 错
生图接口只能用：
/v1/images/generations
3️⃣ 指望中转站“提升效果”
不会。
效果差就是 prompt 不行，或者模型不适合。
4️⃣ 一上来就写复杂业务代码
建议顺序永远是：
curl → 脚本 → 后端 → 前端
八、什么时候不该用 poloapi？
说句实在的：
- 你只用一个模型
- 官方接口稳定可用
- 不需要中转
👉 那你直连官方，反而更简单
poloapi 是工程便利工具，不是“必选项”。
九、一句话总结（工程视角）
poloapi = OpenAI 兼容的中转层
NanoBananaPro = 实际干活的生图模型
你只是换了 Base URL 和 model