NanoBanana 2 API（页面亦称为 Banana 2 API）是一项面向开发者的AI图像生成API服务，提供对 Banana 2 图像生成模型的编程式访问。开发者可通过标准HTTP请求，将文本提示词生成为高质量、照片级写实的图像，并集成到任意应用、网站或工作流中。
一、用途与定位 该服务定位为"对开发者最友好的AI图像生成API"，核心目标是把AI图像生成能力直接嵌入现有产品与自动化流程，例如SaaS产品内嵌生成、电商与营销素材批量生产、游戏资产制作等。官方称可帮助降低约90%的视觉素材生产成本（该数据来自官方描述）。
二、主要能力
- RESTful 接口设计：单一端点、单次请求即可获得生成图像，采用标准HTTP方法与一致的JSON响应，具备完整错误码与幂等操作。
- 生成速度：官方称通常在10秒内返回图像，实际推理时间取决于分辨率与复杂度设置。
- 图像质量：官方称可生成超写实图像，具备精确的提示词遵循度，输出可达4K级别。
- 分辨率与宽高比：支持从512×512到4K的多种输出分辨率，可在请求中指定宽高比与精确尺寸；常见预设包括1:1、16:9、9:16、4:3、3:4，官方另列出3:2、2:3、4:5、5:4、21:9，并支持1K、2K、4K分辨率选项。
- 生成模式：同时支持文生图与图生图两种模式，可上传参考图进行风格迁移、编辑或生成变体（使用同一端点附加参数）。
- 批量与并发：支持发送多个并发请求进行批量生成，每个请求返回任务ID，可轮询完成状态，适合商品目录、内容库等批量操作。
- 自动扩展：官方称基础设施可自动扩展，从原型到生产可处理数千个并发请求。
三、使用方式
- 获取API密钥：免费注册后从控制台生成API密钥，无需信用卡，官方称注册过程不到30秒。
- 发送请求：向Banana 2 API端点发送POST请求，携带提示词与参数，返回任务ID用于状态轮询。
- 接收图像：轮询状态端点（官方建议轮询 /api/status，间隔2-3秒；多数文生图任务在10秒内完成，编辑类任务可能稍长；不建议每秒超过一次以符合速率限制），图像就绪后下载、展示或在流程中处理。 认证方式为在请求头中以Bearer Token传递API密钥，密钥可在控制台生成与管理，并可按权限范围限定以增强安全性。该API与语言无关，任何能发起HTTP请求的编程语言均可使用；官方提供Python、Node.js、JavaScript、cURL等代码示例与SDK。
四、适用场景
- SaaS产品：将AI图像生成直接嵌入产品，用户无需离开应用即可创建视觉内容。
- 电商：批量生成商品照片、生活场景图与营销视觉素材。
- 营销自动化：通过营销流程自动生成社交媒体创意、广告横幅与邮件视觉。
- 游戏开发：以编程方式创建概念图、纹理、角色立绘与环境资产。
五、定价与额度 采用基于积分的简单定价模式：每次图像生成按分辨率消耗固定数量的积分。新账户赠送免费积分，可立即开始生成且无需信用卡；更高用量可选按量付费方案，官方称按图像计费、透明、无隐藏费用、无最低消费承诺。失败请求不消耗积分。免费层账户有合理的速率限制以保证公平使用，付费方案提供显著更高的速率限制并支持数千并发请求，企业方案可申请自定义速率限制。
六、安全与合规 官方称提供API密钥认证、HTTPS加密、速率限制与符合GDPR的数据处理，数据不会离开其安全基础设施。所有生成的图像附带商用许可，可用于产品、营销材料、网站与应用等，无需额外授权费用。
七、错误处理 API返回标准HTTP状态码与JSON格式的详细错误信息，常见错误包括提示词无效（400）、认证失败（401）、超出速率限制（429）与服务器错误（500）。
八、限制与说明 关于具体积分单价、免费积分数量、各分辨率所需积分、速率限制的具体数值、模型底层架构细节以及各SDK的完整清单，官方页面暂未提供明确数据。实际推理时间与输出质量可能受分辨率、复杂度设置及参考图数量影响。
