核心用法
Poyo Nano Banana 2 是一项面向图像生成与编辑的 API 集成技能，通过调用 https://api.poyo.ai/api/generate/submit 端点实现。
功能覆盖
- nano-banana-2-new：纯文本生成图像、参考图引导生成、多图构图合成
- nano-banana-2-new-edit：基于输入图像的智能编辑，支持增删元素、风格迁移、构图调整
标准工作流
1. 根据需求选择模型（生成 vs 编辑）
2. 构建请求体：必填 model、input.prompt，可选 input.image_urls 用于参考或编辑源图
3. 以 Authorization: Bearer <POYO_API_KEY> 提交 POST 请求
4. 保存返回的 task_id
5. 轮询任务状态端点或依赖 callback_url webhook 接收完成通知
关键约束
- 强制 Bearer 认证，API 密钥需妥善管理
- 提示词需具体且结果导向
- 引用图像通过 URL 传递，需确保可访问性
显著优点
- 双模架构：生成与编辑分离，任务类型边界清晰
- 灵活输入：支持纯文本、单图参考、多图构图等多种输入组合
- 异步任务：任务 ID 追踪 + webhook 回调，适配长时生成场景
- 前端对齐：提供
references/frontend-notes.md用于还原官方客户端默认行为
潜在局限
- 外部依赖：服务可用性绑定 PoYo AI 基础设施，无本地降级方案
- URL 限制：参考图需为公开可访问 URL，私有/本地图像需先上传托管
- 轮询成本：未明确任务状态查询频率限制，高频轮询可能触发限流
- 无预览机制：提交后无法中途调整参数，需等待完整生成周期
适合人群
- 需要程序化图像生成能力的开发者
- 希望将 AI 绘图集成至工作流的内容创作者
- 已有 PoYo AI 账户及 API 密钥的技术用户
常规风险
- 密钥泄露：Bearer Token 若硬编码或日志泄露，可能导致配额被盗用
- 内容合规：生成图像需符合 PoYo AI 服务条款，存在内容审核机制
- 成本不可控：图像生成按任务计费，批量/高频调用需预算管控
- 网络单点：API 端点域名变更或故障将中断全部功能