# Nano Banana API (Gemini 2.5 Flash Image) via PiAPI

Base URL: https://api.piapi.ai
Auth: X-API-Key header (get your key at https://piapi.ai/workspace/key)

Documentation: https://piapi.ai/docs/gemini-api/gemini-25-flash-image

## Model

- model: "gemini", task_type: "gemini-2.5-flash-image"
- Price: $0.03 per image (flat)
- Output formats: jpeg, png
- Aspect ratios: 1:1 (default), 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 5:4, 4:5, 21:9

## Text to Image

POST /api/v1/task
{
  "model": "gemini",
  "task_type": "gemini-2.5-flash-image",
  "input": {
    "prompt": "A product mockup of a modern beverage bottle, studio lighting",
    "aspect_ratio": "1:1",
    "output_format": "png"
  }
}

## Image Editing (image reference)

POST /api/v1/task
{
  "model": "gemini",
  "task_type": "gemini-2.5-flash-image",
  "input": {
    "prompt": "Add a small clean brand logo in the top right corner",
    "image_urls": ["https://example.com/reference.jpg"],
    "output_format": "png"
  }
}

## Get Task Result

GET /api/v1/task/{task_id}

Status: "pending" → "processing" → "completed" or "failed"
Image URL: response.data.output.image_urls[0] (or output.image_url)

## Quick Start

1. Get API key: https://piapi.ai/workspace/key
2. Top up: https://piapi.ai/workspace/billing
3. POST /api/v1/task
4. Poll GET /api/v1/task/{task_id} until "completed"
5. Get image from response.data.output.image_urls