Nano 系列

Nano 系列支持文生图以及使用一张或多张参考图进行编辑。UniAll 使用同一 API Key 提供两种请求风格，请按现有客户端和结果格式选择其中一种。

选择接口风格

使用场景	推荐文档	结果格式
Nano Banana 2.1，使用 OpenAI Images 字段和参考图 URL	Nano Banana 2.1 — OpenAI Images	`data[].url` 中的 URL
Nano Banana 2.1，使用 Gemini 字段和 Base64 参考图	Nano Banana 2.1 — Gemini generateContent	`candidates[].content.parts[].inlineData.data` 中的 Base64
`nano-banana-2`、`nano-banana-pro` 或 `nano-banana-2-lite`，使用 OpenAI Images 或异步任务	OpenAI Images 格式	`data[].url` 中的 URL
`nano-banana-2`、`nano-banana-pro` 或 `nano-banana-2-lite`，使用 Gemini	Gemini generateContent 格式	`candidates[].content.parts[].inlineData.data` 中的 Base64

两种方式都使用 https://api.uniall.ai 和同一份 UniAll API Key。不要混用两种格式的参数名。

模型	可用分辨率	默认值	推荐场景
`nano-banana-2.1`	`1k`、`2k`、`4k`	`1k`	同步生成和编辑、最多 14 张参考图及思考档位控制。
`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 任务。

两份 2.1 指引分别说明独立的请求格式：

OpenAI：文生图使用 POST /v1/images/generations，编辑使用 POST /v1/images/edits。鉴权为 Authorization: Bearer <UNIAI_API_KEY>，resolution、aspect_ratio 和 thinking_level 放在顶层。
Gemini：使用 POST /v1beta/models/gemini-nano-banana-2.1:generateContent，鉴权为 x-goog-api-key: <UNIAI_API_KEY>，图片和思考参数分别放在 generationConfig.imageConfig 与 generationConfig.thinkingConfig 中。

两种风格均同步返回一张图片。2.1 不支持 /v1/images/tasks 或 /v1/chat/completions、0.5K/512/8K、搜索、自定义像素尺寸、遮罩、透明背景或流式输出。搜索字段即使为 false 也不要传入。

2.1 支持 14 种画幅：

1:1  1:4  1:8  2:3  3:2  3:4  4:1
4:3  4:5  5:4  8:1  9:16  16:9  21:9

分辨率是档位，并非固定的长边像素；非方形 1K 图片可以是 1376 × 768。PNG/JPEG/WebP 参考图保留顺序及重复项，重复图计入 14 张限制。

思考档位在 OpenAI 中默认 medium，在 Gemini 中默认 MEDIUM，仅对 2.1 开放。不要给 nano-banana-2、nano-banana-pro 或固定分辨率兼容型号添加此参数。

其它三个模型（nano-banana-2、nano-banana-pro 和 nano-banana-2-lite）支持：

1:1  2:3  3:2  3:4  4:3  4:5  5:4  9:16  16:9  21:9

两种接口风格的分辨率字段不同：

0.5K 仅适用于 nano-banana-2。不要传 512K，Gemini 的 imageSize 也不要传 0.5k。

NanoBanana2-1K、NanoBananaPro-2K 等固定分辨率模型名可能仍可兼容使用，但这些属于已弃用的兼容别名，可能随时移除。新接入应使用统一模型 ID，并在请求参数中选择分辨率。