Nano Banana Pro API

Use Nano Banana Pro on Xenodia with resolution tiers, aspect ratio controls, output format, reference inputs, and task mode.

nano-banana-pro uses the shared image endpoint:

POST https://api.xenodia.xyz/v1/images/generations

Use this page when you need explicit control over aspect ratio, resolution, output format, and reference images.

Request

{
  "model": "nano-banana-pro",
  "prompt": "A clean studio render of a developer API dashboard on a glass desk.",
  "aspect_ratio": "16:9",
  "resolution": "2K",
  "output_format": "png",
  "response_format": "url"
}

Task request

{
  "model": "nano-banana-pro",
  "prompt": "Create a polished product hero image for Xenodia docs.",
  "aspect_ratio": "16:9",
  "resolution": "4K",
  "response_format": "url"
}

Poll the returned task through Task Retrieval.

Reference inputs

Nano Banana Pro supports prompt-only generation, URL references, multipart file references, and mixed reference input.

Current public rule:

reference_input.max_items = 8
accepted_mime = image/jpeg, image/png, image/webp
max_size_per_file_bytes = 31457280
transport = url, multipart_file
response_format = url

URL references use image_input; multipart references use image or image[]:

curl -X POST "https://api.xenodia.xyz/v1/images/generations" \
  -H "Authorization: Bearer $XENODIA_API_KEY" \
  -F "model=nano-banana-pro" \
  -F "prompt=Create a polished product hero image using this reference." \
  -F "aspect_ratio=16:9" \
  -F "resolution=4K" \
  -F "response_format=url" \
  -F "image=@./reference.png"

Parameters

Field	Notes
`model`	Must be `nano-banana-pro`.
`prompt`	Required text prompt.
`aspect_ratio`	Model capability data exposes the current enum. Common values include `1:1`, `16:9`, and `auto`.
`resolution`	`1K`, `2K`, or `4K`.
`output_format`	Use when you need a specific image format such as `png` or `jpg`.
`image_input`	Optional URL reference. Repeat the field or use an array for multiple references.
`image` / `image[]`	Optional multipart file references.
`async`	Deprecated compatibility flag. Image generation always returns a `202` task envelope.

Responses and errors

Requests return 202 with task_id, state, and poll_url. Poll with Task Retrieval for the final result.data[].url.

Common error statuses are 400 for invalid parameters, 401 for missing or invalid keys, 402 for billing boundaries, and 502 for generation failures.

Pricing model

Nano Banana Pro is priced by resolution tier. Treat pricing as catalog data: query /v1/models before displaying price-sensitive UI.