Nano 系列
Nano 系列支持文生图以及使用一张或多张参考图进行编辑。UniAll 使用同一 API Key 提供两种请求风格，请按现有客户端和结果格式选择其中一种。
选择接口风格
| 使用场景 | 推荐文档 | 结果格式 |
|---|---|---|
| 已使用 OpenAI Images 客户端、需要图片 URL 或异步任务 | OpenAI Images 格式 | data[].url 中的 URL |
| 已使用 Gemini 客户端，或需要 Base64 图片输入与输出 | Gemini generateContent 格式 | candidates[].content.parts[].inlineData.data 中的 Base64 |
两种方式都使用 https://api.uniall.ai 和同一份 UniAll API Key。不要混用两种格式的参数名。
推荐模型
| 模型 | 可用分辨率 | 默认值 | 推荐场景 |
|---|---|---|---|
nano-banana-2 | 0.5k、1k、2k、4k | 1k | 通用生成、图片编辑和快速 0.5K 预览。 |
nano-banana-pro | 1k、2k、4k | 1k | 更高细节的生成与编辑。 |
nano-banana-2-lite | 1k | 1k | 轻量 1K 任务。 |
新接入请使用这些统一的小写模型 ID。实际可用范围取决于账号已启用的模型。
支持的输出比例
三个模型均支持：
1:1 2:3 3:2 3:4 4:3 4:5 5:4 9:16 16:9 21:9
两种接口风格的分辨率字段不同：
| 输出规格 | OpenAI Images | Gemini generateContent |
|---|---|---|
| 0.5K | resolution: "0.5k" | imageSize: "512" |
| 1K | resolution: "1k" | imageSize: "1K" |
| 2K | resolution: "2k" | imageSize: "2K" |
| 4K | resolution: "4k" | imageSize: "4K" |
0.5K 仅适用于 nano-banana-2。不要传 512K，Gemini 的 imageSize 也不要传 0.5k。
旧版兼容模型名
NanoBanana2-1K、NanoBananaPro-2K 等固定分辨率模型名可能仍可兼容使用，但这些属于已弃用的兼容别名，可能随时移除。新接入应使用统一模型 ID，并在请求参数中选择分辨率。
接入检查清单
n保持为1，当前每次请求只生成一张图片。- OpenAI 风格的参考图使用服务端可访问的 HTTP(S) URL 或完整 Data URL。
- Gemini 的
inlineData.data只放纯 Base64，不要包含data:image/...;base64,前缀。 - 同步调用可按需把客户端超时设置到 600 秒。
- 客户端超时后不要立刻重复提交，原任务仍可能完成。
- 如需长期保留结果，请及时把临时结果 URL 转存到自己的存储。
- 日志中不要记录 API Key 或完整图片 Base64。
计费说明
计费取决于所选模型和分辨率。生产调用前请以账号当前可见的模型价格为准。客户端超时不代表生成或计费已经停止。