核心用法
PoYo Nano Banana 是 PoYo AI 提供的图像生成与编辑模型族，通过 POST https://api.poyo.ai/api/generate/submit 端点提交任务。系统支持两种模式：nano-banana 用于常规文生图，nano-banana-edit 用于基于参考图的图像编辑。请求需 Bearer Token 认证（Authorization: Bearer <POYO_API_KEY>），核心字段包括 model、input.prompt（必填）和可选的 input.image_urls（参考图）、input.size（画布尺寸）。提交后返回 task_id，可通过轮询状态或配置 callback_url 接收 webhook 通知。
显著优点
- 灵活画布：原生支持多种宽高比，适应不同场景需求
- 双模一体：生成与编辑共用同一端点，降低集成复杂度
- 异步架构：任务队列 + 回调机制，适合长时图像渲染
- 文档完备：官方提供模型页、API 手册、密钥管理控制台
潜在局限
- 密钥依赖：必须持有有效 POYO_API_KEY，免费额度或付费策略不明
- 异步延迟：非即时返回结果，需额外实现轮询或 webhook 处理
- 生态封闭：专属于 PoYo AI 平台，迁移成本较高
适合人群
- 需要程序化图像生成的开发者与产品团队
- 已有 PoYo 账户、追求多比例输出和编辑能力的用户
- 具备异步任务处理基础设施的技术栈
常规风险
- 密钥泄露：API Key 存储不当可能导致配额滥用
- 内容合规：生成内容需符合平台审核政策，存在封号风险
- 服务依赖：第三方 SaaS 可用性、定价变更不受控
- 回调安全：若使用 webhook，需验证来源真实性防止伪造通知