Nano Banana 2

google/nano-banana-2 — a image model by Google. Call it through the gateway’s standard OpenAI-compatible door using the catalog slug; the full parameter schema is reproduced in full below.

Catalog slug	google/nano-banana-2
Kind	image
Vendor	Google

How to call

Through the Sociaro SDK / OpenAI-compatible door

from sociaro_ai import Sociaro

client = Sociaro(api_key="gw_live_...")

img = client.images.generate(
    model="google/nano-banana-2",
    prompt="a red fox in the snow",
    # size / n / negative_prompt / seed … — see the schema below
)

Raw door: POST https://api.sociaro.com/v1/images/generations with {"model": "google/nano-banana-2", "prompt": "…"}. See media doors.

Parameters — full schema

The complete, one-to-one API schema for this model, transcribed from the official source. Nothing omitted. Examples in the schema may use a representative model of the family — for this model use the slug google/nano-banana-2 as shown in How to call above.

Scope

Google’s Nano Banana image models are called through the gateway’s standard OpenAI-compatible image door POST /v1/images/generations using the catalog slug — the same contract every image model uses. You send the OpenAI Images request shape; the gateway routes it and returns an OpenAI Images response. Vendor-specific (Google) generation parameters are forwarded as-is when supplied.

Request — POST /v1/images/generations

name	type	required	default	allowed / range	description
model	string	yes	—	catalog slug	The model to call (e.g. google/nano-banana-2).
prompt	string	yes	—	—	Text description of the desired image.
n	integer	no	1	≥ 1	Number of images to generate.
size	string	no	provider default	WxH (e.g. 1024x1024)	Output resolution. Values the model accepts depend on the model.
response_format	string	no	url	url | b64_json	Return a URL or base64-encoded image.
user	string	no	—	—	Stable end-user identifier (abuse monitoring).

Vendor-native fields (Google Nano Banana / Gemini image — e.g. aspect ratio, resolution tier, reference images for editing) are passed through in the request body when provided; consult Google’s Nano Banana documentation for the full vendor parameter set. The gateway does not strip unknown fields.

Response

{
  "created": 1700000000,
  "data": [
    { "url": "https://.../image.png" }
  ]
}

With response_format: "b64_json", each data[] item carries b64_json instead of url.

Minimal example

curl https://api.sociaro.com/v1/images/generations \
  -H "Authorization: Bearer $SOCIARO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "model": "google/nano-banana-2", "prompt": "a red fox in the snow", "n": 1 }'