Google's state-of-the-art image generation and editing model built on Gemini 3 Pro. Creates detailed visuals with legible text in multiple languages, connects to real-time information from Google Search, and provides professional-grade creative controls. 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-pro",
"input": {
"prompt": "35.6586ยฐ N, 139.7454ยฐ E at 19:00",
"resolution": "2K",
"aspect_ratio": "4:3",
"output_format": "png"
}
}'| 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 | 4:3 | Aspect ratio of the generated image match_input_image1:12:33:23:44:34:55:49:1616:921:9 |
resolution | string | No | 2K | Resolution of the generated image 1K2K4K |
output_format | string | No | png | Format of the output image pngjpg |
safety_filter_level | string | No | block_only_high | Safety filter strictness level block_low_and_aboveblock_medium_and_aboveblock_only_high |
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-pro" \
-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-pro",
"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 an image from GPS coordinates and time
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-pro",
"input": {
"prompt": "35.6586ยฐ N, 139.7454ยฐ E at 19:00",
"resolution": "2K",
"aspect_ratio": "4:3",
"output_format": "png"
}
}'Blend multiple reference images into a single composition
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-pro",
"input": {
"prompt": "an office team photo, everyone making a silly face",
"resolution": "2K",
"aspect_ratio": "4:3"
}
}'POST /v1/predictions