---
title: "Create image from text - Nano Banana Pro Flash"
method: POST
path: "/v1/ai/text-to-image/nano-banana-pro-flash"
tags: ["text-to-image"]
---

# Create image from text - Nano Banana Pro Flash

`POST /v1/ai/text-to-image/nano-banana-pro-flash`

## Request

- Base URL: `https://api.magnific.com`
- URL: `https://api.magnific.com/v1/ai/text-to-image/nano-banana-pro-flash`
- Auth: API key in header `x-magnific-api-key`

Generate images from text descriptions using Google's Nano Banana Pro Flash model (Gemini 3.1 Flash), a faster variant of Nano Banana Pro optimized for quick image generation.

**Key Features:**
- Fast image generation with Gemini 3.1 Flash
- Google Search grounding for real-world accuracy
- Support for reference images for guided generation
- Multiple aspect ratios and resolutions up to 4K

**Best for:**
- Rapid image generation with shorter wait times
- Grounded image generation using Google Search
- Reference-guided generation
- Iterative creative workflows where speed matters

## Request body

- TtiNanoBananaProFlashRequest
  - `prompt` string, required: Text prompt describing the image you want to generate. **Tips:** - Be specific about visual details, composition, and style - Nano Banana Pro Flash is optimized for speed while maintaining quality - Enable Google Search grounding for images that need real-world accuracy **Examples:** - Simple: "A suited raccoon smoking a pipe" - Detailed: "A suited raccoon smoking a pipe in a vintage study room, warm lighting, leather armchair, bookshelves in background"
  - `webhook_url` string, uri: Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.
  - `reference_images` TtiNanoBananaProRequestReferenceImagesInner[]: Optional reference images for guided generation. Each image can include associated text and mime type. **Image requirements:** - Maximum 14 images - Supported formats: PNG, JPEG, WebP - Publicly accessible URLs or GCS format
    - `image` string, required: Image URL (publicly accessible URL or GCS format)
    - `text` string: Optional text description to attach to the reference image
    - `mime_type` 'image/png' | 'image/jpeg' | 'image/webp', required: MIME type of the image
  - `aspect_ratio` 'auto' | '1:1' | '2:3' | '3:2' | '4:3' | '3:4' | '5:4' | '4:5' | '16:9' | '9:16' | '21:9': Aspect ratio for the generated image. **Available ratios:** - `auto`: Derived from the reference images, preserving ratios outside this list (for example a 900x1050 reference returns 960x1120). With no reference images the model picks the ratio itself. - `1:1`: Square (default) - `2:3`, `3:2`: Portrait/Landscape - `4:3`, `3:4`: Standard - `5:4`, `4:5`: Photo print - `16:9`, `9:16`: Widescreen/Social stories - `21:9`: Ultra-wide cinematic
  - `resolution` '1K' | '2K' | '4K' | 'low' | 'medium' | 'high': Resolution quality for the generated image. **Available resolutions:** - `1K`: Lower resolution, faster generation (default) - `2K`: Standard resolution, balanced quality/speed - `4K`: High resolution, best quality
  - `use_google_search_tool` boolean: Enable Google Search grounding during image generation. When enabled, the model uses Google Search to ground its output with real-world information, improving accuracy for prompts that reference real places, people, brands, or current events. **Note:** When enabled, the task response may include grounding metadata with source information.

## Response `200`

OK - The request has succeeded and the Nano Banana Pro Flash process has started.

- GetStyleTransferTaskStatus200Response
  - `data` TaskDetail, required
    - `task_id` string, uuid, required: Task identifier
    - `status` 'CREATED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED', required: Task status
    - `generated` string[], required

## Other responses

- `400`: Bad Request - The server could not understand the request due to invalid syntax.
- `401`: Unauthorized - The client must authenticate itself to get the requested response.
- `500`: Internal Server Error - The server has encountered a situation it doesn't know how to handle.
- `503`: Service Unavailable

---

[API](https://skmtc.dev/magnific/apis/magnific-api.md) · [All operations](https://skmtc.dev/magnific/apis/magnific-api/llms.txt) · [OpenAPI document](https://skmtc.dev/magnific/apis/magnific-api/revisions/60711fb082c7?raw)