# Nano Banana 2 API via PiAPI

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

Documentation: {{docs:nano-banana-2}} Model

- model: "gemini", task_type: "nano-banana-2"
- Price: 1K $0.06 / 2K $0.08 / 4K $0.12 per image
- Resolutions: 1K (default), 2K, 4K
- Output formats: jpg, png (default), webp
- Aspect ratios: 1:1, 16:9 (default for text-to-image), 9:16, 4:3, 3:4, 21:9, 3:2, 2:3, 5:4, 4:5, 1:4, 1:8, 4:1, 8:1
- Reference images: up to 14 via input.image_urls

## Text to Image

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

## Image Editing (image reference)

POST /api/v1/task
{
  "model": "gemini",
  "task_type": "nano-banana-2",
  "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