Google's fast image generation model built on Gemini 3.1 Flash Image. The high-efficiency counterpart to Nano Banana Pro โ combining Pro-level visual quality with Flash-level speed and pricing. Features conversational editing, multi-image fusion, character consistency, accurate text rendering, and Google Search grounding. Supports up to 14 reference images and resolutions up to 4K.
Copy usage instructions for Claude, ChatGPT, or other AI
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "google/nano-banana-2",
"input": {
"prompt": "A photorealistic close-up portrait of an elderly Japanese ceramicist with deep wrinkles and a warm smile, carefully inspecting a freshly glazed tea bowl in his rustic sun-drenched workshop.",
"aspect_ratio": "3:4",
"resolution": "2K",
"output_format": "jpg"
}
}'| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
prompt | string | Yes | - | A text description of the image you want to generate |
image_input | array | No | - | Input images to transform or use as reference (supports up to 14 images) |
aspect_ratio | string | No | 1:1 | Aspect ratio of the generated image match_input_image1:11:41:82:33:23:44:14:34:55:48:19:1616:921:9 |
resolution | string | No | 1K | Resolution of the generated image 1K2K4K |
google_search | boolean | No | false | Use Google Web Search grounding for real-time information |
image_search | boolean | No | false | Use Google Image Search grounding for visual context |
output_format | string | No | jpg | Format of the output image pngjpg |
There are 3 ways to provide files for the image_input parameter:
Attach files directly to POST /v1/predictions/upload. No separate upload step needed.
curl -X POST "https://api.core.today/v1/predictions/upload" \
-H "X-API-Key: cdt_your_api_key" \
-F "model=google/nano-banana-2" \
-F 'input={"prompt":"your prompt here"}' \
-F "file:image_input=@your_file.png"Pass a publicly accessible URL directly. You can also use file_url from the Storage API.
{
"model": "google/nano-banana-2",
"input": {
"prompt": "your prompt here",
"image_input": ["https://example.com/image.jpg"]
}
}Common parameters used when calling POST /v1/predictions.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
model | string | Yes | - | Model identifier |
input | object | Yes | - | Object containing the model-specific parameters from the table above |
output_folder | string | No | - | Folder path for output files (max 256 chars, '..' not allowed) |
webhook_url | string | No | - | Webhook URL to call on completion |
is_public | boolean | No | false | If true, output files are also available via permanent public URLs |
Generate a high-quality portrait with natural lighting
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "google/nano-banana-2",
"input": {
"prompt": "A photorealistic close-up portrait of an elderly Japanese ceramicist with deep wrinkles and a warm smile, carefully inspecting a freshly glazed tea bowl in his rustic sun-drenched workshop.",
"aspect_ratio": "3:4",
"resolution": "2K",
"output_format": "jpg"
}
}'Transform a photo into Studio Ghibli anime style using reference image
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "google/nano-banana-2",
"input": {
"prompt": "Transform this photograph into a Studio Ghibli anime style illustration. Keep the same composition but render everything with soft cel-shading, warm colors, and the dreamy atmosphere of a Miyazaki film.",
"aspect_ratio": "match_input_image"
}
}'POST /v1/predictions