Nano Series
Use Nano Series models to generate images from text or edit one or more reference images. UniAll exposes the same API key and model family through two request styles; choose one style for each integration.
Choose An API Style
| Use case | Recommended guide | Result format |
|---|---|---|
| Existing OpenAI Images client, image URLs, or asynchronous jobs | OpenAI Images Format | URL in data[].url |
| Existing Gemini client or Base64 image input and output | Gemini generateContent Format | Base64 in candidates[].content.parts[].inlineData.data |
Both styles use https://api.uniall.ai and the same UniAll API key. Do not mix parameter names between the two formats.
Recommended Models
| Model | Resolutions | Default | Recommended use |
|---|---|---|---|
nano-banana-2 | 0.5k, 1k, 2k, 4k | 1k | General generation, editing, and fast 0.5K previews. |
nano-banana-pro | 1k, 2k, 4k | 1k | Higher-detail generation and editing. |
nano-banana-2-lite | 1k | 1k | Lightweight 1K workloads. |
Use these unified, lowercase model IDs for new integrations. Actual availability depends on the models enabled for your account.
Supported Aspect Ratios
All three models support:
1:1 2:3 3:2 3:4 4:3 4:5 5:4 9:16 16:9 21:9
The resolution field differs by API style:
| Output | 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 is available only for nano-banana-2. Do not send 512K, and do not use 0.5k as a Gemini imageSize.
Legacy Model IDs
Earlier fixed-resolution IDs such as NanoBanana2-1K and NanoBananaPro-2K may remain accepted for compatibility. They are deprecated compatibility aliases and may be removed at any time. New integrations should use a unified model ID and select the resolution in the request.
Integration Checklist
- Keep
nset to1; each request currently generates one image. - Use a server-accessible HTTP(S) URL or a complete Data URL for OpenAI-style reference images.
- Use raw Base64 without a
data:image/...;base64,prefix inside GeminiinlineData.data. - Set synchronous client timeouts up to 600 seconds when needed.
- Do not retry immediately after a client timeout; the original generation may still complete.
- Transfer temporary result URLs to your own storage if you need permanent retention.
- Never log API keys or complete Base64 image payloads.
Billing Notes
Billing depends on the selected model and resolution. Check the current model pricing available to your account before sending production traffic. A client timeout does not necessarily mean generation or billing stopped.