Nano Banana Pro 2K API Tutorial
Nano Banana Pro 2K is a high-quality image generation model available on UniAll AI for teams that need sharper visuals for posters, product assets, brand creatives, and commercial design workflows. The public model id is `NanoBananaPro-2K`.
The model supports both **text-to-image** and **image-to-image** generation through an async API endpoint. It is useful for developers, ecommerce operators, design teams, content platforms, and agencies that want programmable image generation without building model infrastructure.
What Nano Banana Pro 2K can do
Nano Banana Pro 2K is designed for image generation tasks where clarity and visual polish matter. Common use cases include:
- Ecommerce product posters and hero images
- Social media campaign visuals
- Brand concept images
- Commercial graphics and marketing materials
- Reference-image based creative variations
- Automated image generation inside apps or internal tools
Supported generation modes:
| Mode | Description | Required fields | |---|---|---| | `text_to_image` | Generate an image from a text prompt | `prompt` | | `image_to_image` | Generate from a prompt plus one reference image | `prompt`, `image_url` |
API endpoint
Use the UniAll AI image generation endpoint:
```http POST /v1/images/generations ```
The request is asynchronous, so your application should create a generation task and then handle the returned task/result flow according to your UniAll AI integration.
Required and optional parameters
| Parameter | Type | Required | Notes | |---|---:|---:|---| | `model` | string | Yes | Use `NanoBananaPro-2K` | | `generation_mode` | string | Yes | `text_to_image` or `image_to_image` | | `prompt` | string | Yes | Describe the desired image clearly | | `image_url` | string | Required for image-to-image | PNG, JPEG, or WebP reference image URL | | `aspect_ratio` | string | No | `1:1`, `16:9`, `9:16`, `4:3`, `3:4`; default `1:1` | | `resolution` | string | No | `1K`, `2K`, or `4K`; default `1K` | | `num_images` | integer | No | 1 to 4 images; default `1` |
Text-to-image example
```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-2K", "generation_mode": "text_to_image", "prompt": "A premium skincare product poster on a clean marble surface, soft studio lighting, sharp details, elegant beige background", "aspect_ratio": "1:1", "resolution": "2K", "num_images": 1 }' ```
Image-to-image example
```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-2K", "generation_mode": "image_to_image", "prompt": "Turn this product photo into a polished ecommerce hero image with clean lighting, realistic shadows, and a premium campaign style", "image_url": "https://example.com/reference.png", "aspect_ratio": "1:1", "resolution": "2K", "num_images": 1 }' ```
Prompting tips
For better results, include:
1. **Subject**: what should appear in the image. 2. **Scene or background**: studio, outdoor, minimal, luxury, ecommerce, etc. 3. **Lighting**: softbox, cinematic, natural light, high-key studio. 4. **Style**: realistic product photography, poster design, editorial, social ad. 5. **Output constraints**: aspect ratio, clean composition, no clutter, space for text.
Example prompt:
```text A premium product poster for a wireless headphone brand, centered product, dark gradient background, rim lighting, realistic reflections, luxury technology advertising style, sharp details, clean space for headline text ```
Pricing angle
Nano Banana Pro 2K is billed per generated image on UniAll AI. The listed user price is **$0.102 per image** for the 2K tier. The same model family also exposes 1K and 4K resolution options, with 4K priced higher. Failed generations are eligible for refund according to the model configuration, while automatic retry is not enabled by default.
For production workloads, estimate cost as:
```text estimated cost = number of generated images × unit price for selected resolution ```
If you request `num_images: 4`, the charge is based on four generated images, not one API call.
Who should use it
Nano Banana Pro 2K is a good fit for:
- Developers adding AI image generation to SaaS products
- Ecommerce teams generating product images and campaign assets
- Marketing teams creating posters and social creatives
- Agencies building repeatable visual production workflows
- Businesses that need a domestic or overseas-accessible AI image API through UniAll AI
Implementation notes
- Use `NanoBananaPro-2K` exactly as the `model` value.
- Use `generation_mode` to choose text-to-image or image-to-image.
- Provide only one reference image via `image_url` for image-to-image.
- Keep prompts specific, especially for commercial images.
- Handle async task status and failures in your application.
- For batch jobs, control `num_images` and concurrency based on your account limits and budget.
常见问题
What is the Nano Banana Pro 2K API used for?
The Nano Banana Pro 2K API is used to generate high-quality AI images from text prompts or from a prompt plus one reference image. It is suitable for ecommerce visuals, product posters, brand assets, social media images, and commercial creative workflows.
What is the correct model id for Nano Banana Pro 2K?
Use `NanoBananaPro-2K` as the public model id in the `model` field when calling the UniAll AI image generation endpoint.
How is Nano Banana Pro 2K priced?
Nano Banana Pro 2K is billed per generated image. The listed user price for the 2K tier is $0.102 per image. If you generate multiple images in one request, billing is based on the number of output images.