# Nano Banana 2.1 API 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/nano-banana-2

## Model

- model: "gemini", task_type: "nano-banana-2.1"
- Price: 1K $0.03 / 2K $0.04 / 4K $0.09 per image
- Resolutions: 1K (default), 2K, 4K
- Output formats: jpg or png (default png)
- Aspect ratios: 21:9, 1:1 (default), 4:3, 3:2, 2:3, 5:4, 4:5, 3:4, 16:9, 9:16
- Reference images: up to 9 via input.image_urls

## Text to Image

POST /api/v1/task
{
  "model": "gemini",
  "task_type": "nano-banana-2.1",
  "input": {
    "prompt": "A modern smartphone on a reflective surface, luxury product photography",
    "resolution": "1K",
    "aspect_ratio": "1:1",
    "output_format": "png"
  }
}

## Image Editing (image reference)

POST /api/v1/task
{
  "model": "gemini",
  "task_type": "nano-banana-2.1",
  "input": {
    "prompt": "Keep the phone design and add a hand that holds the phone.",
    "image_urls": ["https://example.com/reference.jpg"],
    "resolution": "1K"
  }
}

## Get Task Result

GET /api/v1/task/{task_id}

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

## 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