Nano Banana Pro 是什么
Nano Banana Pro 是一款高质量 AI 图片生成模型,适合用于商品图、海报、品牌视觉、社媒配图和参考图创作。通过 UniAll AI,你可以使用公开模型 ID `NanoBananaPro-1K` 调用该模型,并在请求中选择 1K、2K 或 4K 输出规格。
该模型支持两类常见工作流:
- **文生图**:仅提供 `prompt`,根据文字描述生成图片。
- **图生图**:提供 `prompt` 与 `image_url`,基于参考图进行风格、构图或产品视觉创作。
当前接口为异步图片生成,适合接入网站、SaaS 工具、自动化内容生产系统或企业内部创意工作流。
适合哪些用户
Nano Banana Pro 更适合以下场景:
- 电商团队:生成商品主图、详情页配图、促销海报。
- 设计与营销团队:快速制作品牌视觉、社媒素材和广告草图。
- 开发者:将图片生成能力集成到自己的应用或工作流。
- 企业与代理系统:通过 API 批量生成图片,统一管理模型、价格与调用逻辑。
如果你的业务需要高清输出,可以选择 4K;如果主要用于预览、草图或批量测试,1K/2K 通常更节省成本。
API 基本信息
- **接口路径**:`/v1/images/generations`
- **请求方法**:`POST`
- **模型 ID**:`NanoBananaPro-1K`
- **计费单位**:按图片计费
- **任务类型**:异步生成
- **支持模式**:`text_to_image`、`image_to_image`
主要参数
| 参数 | 类型 | 是否必填 | 说明 | |---|---:|---:|---| | `model` | string | 是 | 使用 `NanoBananaPro-1K` | | `generation_mode` | string | 建议填写 | `text_to_image` 或 `image_to_image` | | `prompt` | string | 是 | 图片生成提示词 | | `image_url` | string | 图生图必填 | 参考图 URL,支持 PNG、JPEG、WebP | | `aspect_ratio` | string | 否 | 可选:`1:1`、`16:9`、`9:16`、`4:3`、`3:4` | | `resolution` | string | 否 | 可选:`1K`、`2K`、`4K`,默认 1K | | `num_images` | integer | 否 | 生成张数,范围 1–4,默认 1 |
文生图调用示例
```bash curl -X POST "https://api.uniall.ai/v1/images/generations" \ -H "Authorization: Bearer $UNIALL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "NanoBananaPro-1K", "generation_mode": "text_to_image", "prompt": "A premium skincare product poster, clean studio lighting, minimal background, sharp details", "aspect_ratio": "1:1", "resolution": "1K", "num_images": 1 }' ```
图生图调用示例
```bash curl -X POST "https://api.uniall.ai/v1/images/generations" \ -H "Authorization: Bearer $UNIALL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "NanoBananaPro-1K", "generation_mode": "image_to_image", "prompt": "Turn the reference product into a luxury e-commerce hero image with soft shadows and a clean beige background", "image_url": "https://example.com/reference.png", "aspect_ratio": "1:1", "resolution": "2K", "num_images": 1 }' ```
Python 示例
```python import requests
url = "https://api.uniall.ai/v1/images/generations" headers = { "Authorization": "Bearer YOUR_UNIALL_API_KEY", "Content-Type": "application/json" }
payload = { "model": "NanoBananaPro-1K", "generation_mode": "text_to_image", "prompt": "A modern electric scooter product poster, cinematic lighting, white background", "aspect_ratio": "16:9", "resolution": "1K", "num_images": 1 }
response = requests.post(url, headers=headers, json=payload) print(response.json()) ```
分辨率与价格建议
Nano Banana Pro 按图片计费,不同分辨率价格不同。面向普通用户的参考价格为:
- **1K**:约 `$0.102 / image`
- **2K**:约 `$0.102 / image`
- **4K**:约 `$0.204 / image`
API、合作伙伴或企业方案可能使用不同价格档。实际扣费应以你的 UniAll AI 控制台和账户配置为准。
选型建议:
- 草图、批量测试、提示词调试:优先用 1K。
- 常规海报、电商图、社媒图:可用 2K。
- 高清展示、落地页主视觉、印刷前预览:选择 4K。
接入注意事项
1. `prompt` 是唯一必填的核心参数;图生图时需要额外传入 `image_url`。 2. 单次请求最多生成 4 张图片,建议在批量任务中控制并发和预算。 3. 参考图应使用可访问的公网 URL,并确保格式为 PNG、JPEG 或 WebP。 4. 生成失败通常不应直接无限重试,建议记录请求参数、错误信息和任务状态后再决定是否重发。 5. 如果用于企业应用,建议封装统一的模型层,方便后续在 1K、2K、4K 或其他图片模型之间切换。
小结
通过 UniAll AI 的 OpenAI 兼容图片生成接口,开发者可以较低改造成本接入 Nano Banana Pro。对于需要文生图、图生图、商品视觉、海报生成和高清输出的应用,`NanoBananaPro-1K` 是一个适合快速上线和规模化调用的图片模型入口。
常见问题
Nano Banana Pro API 如何调用?
使用 UniAll AI 的 `/v1/images/generations` 接口发起 POST 请求,传入 `model: "NanoBananaPro-1K"`、`prompt`,并按需设置 `generation_mode`、`image_url`、`aspect_ratio`、`resolution` 和 `num_images`。
Nano Banana Pro 支持哪些生成方式?
支持文生图和图生图。文生图只需要提示词;图生图需要提示词和一张参考图 URL,参考图格式支持 PNG、JPEG 和 WebP。
Nano Banana Pro 怎么计费?
Nano Banana Pro 按图片计费。普通用户参考价格为 1K/2K 约 0.102 美元每张,4K 约 0.204 美元每张。具体价格以 UniAll AI 控制台和账户方案为准。