Gemini 3 Pro Image Preview (Nano Banana Pro)

gemini-3-pro-image-preview is the premium Gemini image model for high-quality generation and editing. nano-banana-pro is an alias for the same model id contract. Standard, 2K, and 4K outputs are requested through the size field rather than separate model ids.

API surface

Operation	Endpoint	Mode
Image generation	POST /v1/images/generations	Sync
Image generation task	POST /v1/async/images/generations	Async
Image editing	POST /v1/images/edits	Sync
Image editing task	POST /v1/async/images/edits	Async

Pricing

Credits

Model id	Resolution	Credits / image
gemini-3-pro-image-preview	1K (1024px)	8
gemini-3-pro-image-preview-2k	2K (2048px)	8
gemini-3-pro-image-preview-4k	4K (4096px)	16

Request fields

This model uses the same OpenAI-compatible image fields as the rest of Pixapi.

Field	Type	Required	Description
model	string	Yes	Use gemini-3-pro-image-preview or the alias nano-banana-pro.
prompt	string	Yes	Describe the desired image or edit.
image	file or file[]	Required for edits	Send via /v1/images/edits when editing input images.
n	number	No	Number of images to return.
size	string	No	Output size such as 1024x1024, 2048x1152, 3840x2160, or another model-supported size.
response_format	string	No	url or b64_json when supported.

Example

{
  "model": "gemini-3-pro-image-preview",
  "prompt": "A premium product photo with natural lighting and precise composition",
  "n": 1,
  "size": "1024x1024"
}

For the shared response shape and edit upload example, see the API Reference.