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.
Get API Key
Create auth keys for apps and agents
See Usage
Track requests, credits, and logs
Buy Credits
Top up prepaid API capacity
API Endpoint
/api/v1/models/nano-banana-2-1/runTest 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.
LLM.txt
For AI assistants
Copy this model's documentation into Claude, GPT, or any AI for instant integration help.
/llm/nano-banana-2-1.txtOpenAPI Spec
Swagger compatible
Import into Postman, Swagger UI, or generate client SDKs in any language.
/api/openapiParameters
Input parameters accepted by this model
| Parameter | Type | Default |
|---|---|---|
promptrequired | string | - |
aspect_ratio | enum | 1:1 |
resolution | enum | 2K |
reference_images | array | - |
Use saved characters (@Name)
@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
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
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Code Examples
Copy and paste to get started
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)
{
"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
{
"jobId": "job_abc123...",
"status": "completed",
"output": {
"images": [
"https://temp.pixeldojo.ai/pixeldojotemp/1705930123-456789.png"
]
},
"creditCost": 1,
"expiresAt": "2026-11-17T15:31:38Z"
}