Nano Banana 2 图像生成

解决什么问题

当用户只想从文字描述或参考图得到一张可交付图片，但外部图像 API 常存在参数不合法、密钥散落、请求慢导致误重试、重复提交消耗积分等问题时，nano-banana2 把调用过程收敛成可校验、可复现的流程。它不处理视频、音频、OCR 或普通图片编辑，只聚焦文生图与图生图。

工作方式

• 输入边界：必填 prompt，可选 urls、aspectRatio、imageSize，认证信息为 x-api-key。非法比例回退 auto，非法尺寸回退 1K。
• Key 策略：优先使用对话中显式提供的 key，其次环境变量 X_API_KEY，仅在显式启用时读取本地 .env；日志和回显需掩码，避免泄露完整密钥。
• 调用约束：每次请求前输出摘要并等待确认；固定调用 imgEditNB2 接口，设置 curl -m 600 超时；默认单轮最多一次调用，不自动重试，失败后需用户明确同意再执行。
• 结果结构：返回参数摘要、成功或失败状态、已回退字段和下一步建议，便于在自动化流程中继续消费。

注意点

该接口生成时间可能较长，不能因为等待而杀进程或重复提交。密钥来自第三方服务，使用前应确认合规性与可信性；若遇到 401、429、5xx 或超时，默认停止自动重试，先向用户说明风险。