概览
- 模型: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。
认证
在 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 张,确保尺寸和风格一致,避免低分辨率或过曝图片。
