核心用法
PoYo Nano Banana Pro Image Generation and Editing Skill 是面向 PoYo 平台 Nano Banana Pro 系列模型的轻量级 API 封装工具。该 Skill 通过调用 https://api.poyo.ai/api/generate/submit 端点，实现文本到图像生成、图像编辑、多参考图像工作流等核心功能。
使用时需配置 POYO_API_KEY 环境变量，支持两种模型模式：nano-banana-pro 用于文生图及参考引导生成，nano-banana-pro-edit 用于基于源图像的编辑任务。关键输入参数包括 prompt（必填）、image_urls（编辑/参考时使用）、size（尺寸控制）、resolution（1K/2K/4K 质量层级）、output_format（输出格式）以及可选的 callback_url（异步回调）。
Skill 提供两种执行方式：通过 references/api.md 获取详细 API 文档和 curl 示例，或使用 scripts/submit_nano_banana_pro.sh 脚本直接提交 JSON 负载。任务提交后返回 task_id，支持轮询状态或等待 webhook 通知。
显著优点
极简依赖架构：Skill 仅依赖系统标准工具 curl，无第三方包管理依赖，彻底规避供应链攻击风险，代码总量仅 256 行且 90% 以上为文档。
官方 API 直连：所有网络请求均指向 PoYo 官方域名 api.poyo.ai，采用 TLS 1.2+ 加密传输，无中间代理或数据中转环节，确保数据传输安全。
生产级功能覆盖：完整支持 PoYo Nano Banana Pro 全系能力，包括多图参考生成、4K 超高清输出、异步任务队列、webhook 回调等高级特性，满足专业图像生产需求。
安全设计透明：文档明确强制 API 密钥服务器端管理，禁止前端暴露，并通过六维安全检测验证无密钥硬编码、无恶意代码模式、无混淆逻辑。
潜在缺点与局限性
来源可信度受限：维护者为个人开发者 coolhackboy，非知名组织或企业背书，代码长期维护持续性存在不确定性，需用户自行承担版本迭代风险。
功能范围单一：Skill 定位为轻量级 API 封装，不包含图像预处理、后处理、批量任务管理或本地缓存等增值功能，复杂工作流需用户自行搭建。
外部服务强依赖：核心功能完全依赖 PoYo 平台 API 可用性，若 PoYo 服务中断、调整定价或修改接口规范，Skill 将直接失效，无离线降级方案。
密钥管理责任：虽然 Skill 不泄露密钥，但用户需在自有环境中安全配置 POYO_API_KEY，配置不当（如误提交至版本控制）将导致直接经济损失。
适合的目标群体
- AI 图像创作者：需要通过 API 批量生成或编辑高质量视觉内容的插画师、设计师、营销创意人员。
- 开发集成者：希望快速集成 PoYo Nano Banana Pro 能力至自有产品或工作流的后端工程师、DevOps 人员。
- 自动化场景需求者：需要异步任务队列、webhook 回调、4K 输出等生产级特性的企业级图像处理场景。
- 安全敏感型用户：重视依赖最小化、供应链安全、代码可审计性的技术团队。
使用风险与建议
API 密钥泄露风险：密钥若配置于不安全环境（前端代码、公开仓库、日志系统）将直接导致账户被盗用。必须严格遵循文档要求，使用服务器端环境变量或密钥管理服务。
成本控制风险：4K 分辨率及高频调用可能产生显著费用，建议实施调用限流、监控用量并设置预算告警。
回调端点安全风险：若启用 callback_url，需验证回调来源真实性，防范伪造请求攻击，建议实施签名验证或 IP 白名单。
内容合规风险：Skill 将用户输入的 prompt 和 image_urls 转发至 PoYo，需确保不传输敏感个人信息或违反服务条款的内容。
上游变更风险：PoYo API 文档或端点可能更新，建议定期审查官方文档并关注 Skill 版本更新。