Gemini Image

Parameters below were verified against the live model directory on November 5, 2026. Check the model directory for current schema, availability, and prices.

Overview

Nano Banana Pro is Google’s professional image generation and editing model for complex visual briefs, high-fidelity product mockups, accurate text, and controlled creative production. It is designed for tasks where products, people, written content, layout, and visual references must work together inside one polished asset. Nano Banana Pro is built for polished commercial assets, including product mockups, packaging concepts, campaign graphics, menus, and branded compositions. Its reasoning-driven image workflow helps coordinate products, people, text, materials, and layout inside complex briefs where visual consistency and production-ready detail matter more than rapid, low-cost experimentation.

The full model guide, live parameter schema, and playground for every model ID are available in the HiPix model directory.

Model IDs

Model ID	Mode	Notes
google/gemini-2-5-flash-image	Text-to-Image, Image-to-Image
google/gemini-3-1-flash-image	Text-to-Image, Image-to-Image
google/gemini-3-1-flash-image-economy	Image-to-Image, Text-to-Image
google/gemini-3-1-flash-image/text-to-image	Text-to-Image
google/gemini-3-1-flash-lite-image	Text-to-Image, Image-to-Image
google/gemini-3-pro-image	Text-to-Image, Image-to-Image
google/gemini-3-pro-image-economy	Image-to-Image, Text-to-Image
google/gemini-3-pro-image/text-to-image	Text-to-Image

Parameters

Requests are submitted to POST /v1/videos (video) or POST /v1/images/generations / POST /v1/images/edits (image). Fields marked metadata.* travel inside the metadata object.

google/gemini-2-5-flash-image, google/gemini-3-1-flash-lite-image

API field	Type	Required	Values / limit
prompt	string	Yes	—
image	array	No	up to 10; ≤10 MB each; images
image_size	enum	Yes	1K; default 1K
aspect_ratio	enum	Yes	1:1, 4:3, 3:4, 9:16, 16:9, 21:9; default 9:16

google/gemini-3-1-flash-image, google/gemini-3-1-flash-image-economy

API field	Type	Required	Values / limit
prompt	string	Yes	—
image	array	No	up to 10; ≤10 MB each; images
image_size	enum	Yes	1K, 2K, 4K; default 2K
aspect_ratio	enum	Yes	1:1, 4:3, 3:4, 9:16, 16:9, 21:9; default 9:16

google/gemini-3-1-flash-image/text-to-image

API field	Type	Required	Values / limit
prompt	string	Yes	—
image_size	enum	Yes	1K, 2K, 4K; default 2K
aspect_ratio	enum	Yes	1:1, 4:3, 3:4, 9:16, 16:9, 21:9; default 16:9

google/gemini-3-pro-image, google/gemini-3-pro-image-economy

API field	Type	Required	Values / limit
prompt	string	Yes	—
image	array	No	up to 10; ≤10 MB each; images
image_size	enum	Yes	1K, 2K, 4K; default 1K
aspect_ratio	enum	Yes	1:1, 4:3, 16:9, 9:16, 3:4, 21:9; default 1:1

google/gemini-3-pro-image/text-to-image

API field	Type	Required	Values / limit
prompt	string	Yes	—
image_size	enum	Yes	1K, 2K, 4K; default 1K
aspect_ratio	enum	Yes	1:1, 4:3, 16:9, 9:16, 3:4, 21:9; default 9:16

Example

A minimal request for google/gemini-3-pro-image/text-to-image:

curl -X POST https://api.apimart.cc/v1/images/generations \
  -H "Authorization: Bearer $HIPIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "google/gemini-3-pro-image/text-to-image", "prompt": "A kitten running through a sunlit garden", "image_size": "1K", "aspect_ratio": "9:16"}'

Limits, availability, and pricing

• Submit only the input types listed for the exact model ID; unsupported inputs are rejected or removed on HiPix.
• See Submit a Video Task or the model directory for the full request contract, and Pricing & Billing for how charges are settled.
• Prices and availability are shown per model ID in the model directory.