# Nano Banana Pro (Edit) - Core.Today AI API

> Edit endpoint for Nano Banana Pro built on Gemini 3 Pro. Professional-grade controls, legible multilingual typography, real-time grounding via Google Search, and resolution up to 2K for editing.

- **Provider**: Google
- **Model ID**: fal-ai/nano-banana-pro/edit
- **Category**: Image Generation
- **Credits**: 350 per image (1K); 700 for 2K
- **Speed**: Medium
- **Quality**: Ultra

## Features
- Gemini 3 Pro reasoning for complex edits
- Legible text rendering in multiple languages
- Web search grounding
- Up to 2K resolution editing
- Multi-image fusion with character consistency

## Use Cases
- Professional retouching with brand text
- Multilingual marketing localization
- Information-grounded illustrations
- High-fidelity multi-reference composition

## API Endpoint

Base URL: https://api.core.today/v1
Create Prediction: POST /predictions
Get Status: GET /predictions/{job_id}

## Authentication
Header: X-API-Key: YOUR_API_KEY

## Input Parameters

### Required
- **prompt**: string - How you want to edit the image
- **image_urls**: array - Input image URLs to edit

### Optional
- **num_images**: integer (default: 1) - Number of images to generate
- **seed**: integer - The seed for the random number generator.
- **aspect_ratio**: string (default: auto) - Output aspect ratio
  Options: auto, 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16
- **output_format**: string (default: png) - Output image format
  Options: jpeg, png, webp
- **safety_tolerance**: string (default: 4) - The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict.
  Options: 1, 2, 3, 4, 5, 6
- **sync_mode**: boolean (default: false) - If `True`, the media will be returned as a data URI and the output data won't be available in the request history.
- **system_prompt**: string - Optional system instruction that steers the model's persona and output style across the request. Leave blank to omit; when provided, it is sent as the system instruction to Gemini (or as a system message on OpenAI-compatible providers).
- **resolution**: string (default: 1K) - Output resolution — pricing scales with resolution
  Options: 1K, 2K, 4K
- **limit_generations**: boolean (default: true) - Experimental parameter to limit the number of generations from each round of prompting to 1. Set to `True` to to disregard any instructions in the prompt regarding the number of images to generate.
- **enable_web_search**: boolean (default: false) - Enable web search grounding for real-time information

## Examples

### Brand-consistent Retouch
Apply professional retouching while preserving brand assets
```json
{
  "model": "fal-ai/nano-banana-pro/edit",
  "input": {
    "prompt": "Make the colors more vibrant and add a sunset glow",
    "image_urls": [
      "https://example.com/input-image.jpg"
    ],
    "aspect_ratio": "match_input_image",
    "resolution": "1K",
    "output_format": "png",
    "num_images": 1
  }
}
```

## Response Format
```json
{
  "job_id": "abc123",
  "status": "pending | processing | completed | failed",
  "result": "URL or data (when completed)"
}
```

## Usage Flow
1. POST /predictions with model and input -> receive job_id
2. GET /predictions/{job_id} -> poll until status is completed or failed
3. Result contains output URL(s)

## Tips
- Use 2K only for final renders — 1K is much cheaper for iteration
- Combine multiple image_urls for high-fidelity composition
- Enable web search for edits that depend on real-world facts
- Best when prompt and brand text need to be rendered legibly