Skip to main content

UNLIMITED

Flux 3 Klein, H3 Image, Qwen 2.1, MiniMax H3 Video, 310+ effectsSee plans
Back to API Platform

Image Generation

Google Nano Banana 2.1 API

Sharper layouts and subject consistency, with more precise edits. Integrate this model via REST with endpoint docs, parameters, and code examples.

Editing
Credit Cost
1 credit
Type
Image

API Endpoint

POST
/api/v1/models/nano-banana-2-1/run

Test This Model

Run a real request through the API pipeline and inspect the exact input and output your integration will handle. Uses your credits like any API call; failed runs are refunded automatically.

Parameters

Input parameters accepted by this model

ParameterTypeDefault
prompt
required
string
-
aspect_ratio
enum
1:1
resolution
enum
2K
reference_images
array
-

Use saved characters (@Name)

Write @Name in the prompt to use a character, product, outfit, location, prop or style saved in the account's Character Studio, for example "@Mara on a beach at sunset". Its photos are added to reference_images automatically, after any images you send yourself, so your own image numbering is unchanged. List saved names with GET /api/v1/characters and save new ones with POST /api/v1/characters. An @word that names nothing saved stays plain text.

Supported Aspect Ratios

1:1
2:3
3:2
3:4
4:3
4:5
5:4
9:16
16:9
21:9

See also

Related endpoints on this model. You may need a different apiId for a different operation (e.g. image edit vs generation).

Example Outputs

Real outputs generated by this model

Google Nano Banana 2.1 example: A cinematic side-profile portrait of an astronaut standing on a rocky alien beach at sunset, salt spray in the air, t...
View Details

A cinematic side-profile portrait of an astronaut standing on a rocky alien beach at sunset, salt spray in the air, twin suns glowing on the horizon, helmet visor catching warm orange light, weathered patches on the spacesuit. Anamorphic lens, soft rim light, sharp focus on the visor.

1 credit
14.3s
Google Nano Banana 2.1 example: Wide-angle real estate photograph of a mid-century modern living room, a walnut credenza, a camel leather sofa and a...
View Details

Wide-angle real estate photograph of a mid-century modern living room, a walnut credenza, a camel leather sofa and a round wool rug, floor-to-ceiling windows looking onto a garden, warm afternoon light filling the room. Straight verticals, bright and inviting listing photo.

1 credit
29.4s
Google Nano Banana 2.1 example: Top-down flat lay of amber glass skincare bottles, a jar of capsules, dried lavender and a smooth river stone on natu...
View Details

Top-down flat lay of amber glass skincare bottles, a jar of capsules, dried lavender and a smooth river stone on natural linen, soft daylight, a calm sage and cream palette with clean negative space. Editorial wellness brand photograph.

1 credit
13.0s
Google Nano Banana 2.1 example: Aerial photograph of a Mediterranean coastal village, whitewashed houses with blue doors cascading down a cliff to a...
View Details

Aerial photograph of a Mediterranean coastal village, whitewashed houses with blue doors cascading down a cliff to a turquoise harbor, small wooden fishing boats at anchor, golden afternoon light. Travel magazine cover, crisp and saturated.

1 credit
13.1s
Google Nano Banana 2.1 example: Candid portrait of three co-founders, two women and one man in smart casual clothes, laughing together around a stand...
View Details

Candid portrait of three co-founders, two women and one man in smart casual clothes, laughing together around a standing desk in a startup office with exposed brick and warm wood, big windows letting in soft natural light. Editorial business photography.

1 credit
13.3s
Google Nano Banana 2.1 example: Studio portrait of a golden retriever sitting upright, head slightly tilted, sharp focused amber eyes with a bright c...
View Details

Studio portrait of a golden retriever sitting upright, head slightly tilted, sharp focused amber eyes with a bright catch light, soft beauty dish lighting on glossy fur, neutral grey backdrop. Professional pet photography, magazine cover quality.

1 credit
13.0s
Google Nano Banana 2.1 example: Fashion magazine cover: a model in a sculptural red coat against a deep teal studio backdrop, head turned toward came...
View Details

Fashion magazine cover: a model in a sculptural red coat against a deep teal studio backdrop, head turned toward camera, bold masthead reading "MODE" at the top, two short cover lines on the left side. Glossy high-fashion lighting, rich saturated color grade.

1 credit
13.1s
Google Nano Banana 2.1 example: Candid lifestyle photograph of a woman in a cream knit sweater laughing over a cappuccino at a sunlit cafe window sea...
View Details

Candid lifestyle photograph of a woman in a cream knit sweater laughing over a cappuccino at a sunlit cafe window seat, morning light on her face, a croissant and a paperback on the table. Natural skin texture, 50mm lens, warm brand campaign look.

1 credit
13.0s
Google Nano Banana 2.1 example: Top-down flat lay of woodworking tools on natural linen: a chisel set, a brass hand plane, a folding rule, a pencil a...
View Details

Top-down flat lay of woodworking tools on natural linen: a chisel set, a brass hand plane, a folding rule, a pencil and a small block of walnut, arranged on a tidy grid with even spacing. Soft daylight, warm neutral tones, editorial catalog style.

1 credit
13.0s
Google Nano Banana 2.1 example: An athlete mid-deadlift in a sun-streaked industrial gym, chalk dust drifting in a beam of window light behind her, t...
View Details

An athlete mid-deadlift in a sun-streaked industrial gym, chalk dust drifting in a beam of window light behind her, tense shoulders and sweat on her skin, slight motion blur on the bar. Dramatic backlight, gritty fitness brand campaign photograph.

1 credit
16.2s
Google Nano Banana 2.1 example: Character reference sheet of one young woman with a short copper bob, freckles, green bomber jacket and black jeans,...
View Details

Character reference sheet of one young woman with a short copper bob, freckles, green bomber jacket and black jeans, shown three times side by side: front view, left profile and three-quarter view, full body, same outfit and proportions in each. Neutral grey background, even studio lighting, no text.

1 credit
9.8s

Code Examples

Copy and paste to get started

bash
curl -X POST "https://pixeldojo.ai/api/v1/models/nano-banana-2-1/run" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "a watercolor fox at dawn",
    "resolution": "1K"
  }'

Response Format

Submit Response (202 Accepted)

json
{
  "jobId": "job_abc123...",
  "status": "pending",
  "statusUrl": "https://pixeldojo.ai/api/v1/jobs/job_abc123...",
  "creditCost": 1,
  "creditsRemaining": 95,
  "expiresAt": "2026-11-17T15:31:38Z"
}

Completed Response

json
{
  "jobId": "job_abc123...",
  "status": "completed",
  "output": {
    "images": [
      "https://temp.pixeldojo.ai/pixeldojotemp/1705930123-456789.png"
    ]
  },
  "creditCost": 1,
  "expiresAt": "2026-11-17T15:31:38Z"
}