Skip to main content

概览

  • 模型:Nano Banana Pro,支持文生图与多参考图(最多 8 张,30MB/张)。
  • 分辨率:1K、2K、4K;默认 1K,高分辨率消耗更多积分。
  • 画幅:1:1、16:9、9:16、21:9 等 10+ 选项,支持 auto。
  • 输出:png/jpg/jpeg,默认 png。
  • 异步接口:提交 POST /api/v1/task/submit/nano-banana-pro,查询 POST /api/v1/task/status。
Breaking Change(2025-12-10):图片输入字段已从 image_input 统一为 image_urls 数组,请尽快迁移。

认证

在 Header 里加入:

提交任务

接口:POST /api/v1/task/submit/nano-banana-pro,Content-Type: application/json
  • 参考图:建议使用清晰主体、风格一致的图像,数量 1-3 张常见,最多 8 张。
  • 画幅与构图:1:1 适合社媒封面,16:9 适合横屏,9:16 适合竖屏移动端,21:9 适合电影感宽屏。

请求示例(文生图)

请求示例(多参考图/风格迁移)

任务查询

接口:POST /api/v1/task/status
客户端可见状态为 PENDING、QUEUED、PROCESSING、REVIEW_REQUIRED、SUCCEEDED、FAILED。详见任务状态参考。

积分计费

提交前通过 /pricing 获取当前档位。

速率限制

限流可能调整。HTTP 429 时遵守 retry_after 或 X-Retry-After;付费提交结果不明确时不得自动重新提交。

迁移指引(image_input → image_urls)

旧版(已废弃)

新版(当前)

最佳实践

  • 提示词写清主体、场景、光线、风格(如 photorealistic、digital art)。
  • 先用 1K/2K 快速迭代,定稿再切换 4K。
  • 竖屏内容优先选 9:16,横屏内容用 16:9 或 21:9;不确定时可用 auto。
  • 参考图数量控制在 1-3 张,确保尺寸和风格一致,避免低分辨率或过曝图片。