# Nano Banana - Core.Today AI API

> Google Gemini 2.5 Flash-based image generation with multimodal editing capabilities. Fast and versatile for both creation and editing tasks.

- **Provider**: Google
- **Model ID**: google/nano-banana
- **Category**: Image Generation
- **Credits**: 91 per image
- **Speed**: Fast
- **Quality**: High

## Features
- Gemini 2.5 Flash-powered generation
- Multimodal image editing
- Fast generation speed
- Multiple aspect ratio support

## Use Cases
- Quick image generation and editing
- Multimodal creative workflows
- Social media content creation
- Rapid visual prototyping

## 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 - Text description of the image to generate or editing instructions

### Optional
- **image_input**: array (default: []) - Input image URL array for transformation/reference
- **aspect_ratio**: string (default: match_input_image) - Output aspect ratio
  Options: match_input_image, 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
- **output_format**: string (default: jpg) - Output image format
  Options: jpg, png

## Examples

### Creative Illustration
Generate a creative illustration with Gemini
```json
{
  "model": "google/nano-banana",
  "input": {
    "prompt": "Whimsical illustration of a cat astronaut floating in space with planets and stars, colorful and playful style",
    "aspect_ratio": "1: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
- Provide an input image URL to use editing mode
- Works great for both generation and editing in one model
- Use specific aspect ratios to match your target platform
- Combine text prompts with input images for powerful edits