# Nano Banana Pro API (Gemini 3 Pro Image) 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-pro}} Model

- model: "gemini", task_type: "nano-banana-pro"
- Price: 1K/2K $0.105 per image, 4K $0.18 per image
- Resolutions: 1K (default), 2K, 4K
- Output formats: jpeg, png (default)
- Aspect ratios: 1:1 (default for text-to-image), 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 5:4, 4:5, 21:9
- Reference images: up to 14 via input.image_urls
- safety_level: low | medium | high (default high)

## Text to Image

POST /api/v1/task
{
  "model": "gemini",
  "task_type": "nano-banana-pro",
  "input": {
    "prompt": "A clean tech poster with the headline 'AI FOR EVERYONE', 4K resolution",
    "resolution": "1K",
    "aspect_ratio": "1:1",
    "output_format": "png"
  }
}

## Image Editing (image reference)

POST /api/v1/task
{
  "model": "gemini",
  "task_type": "nano-banana-pro",
  "input": {
    "prompt": "Change the background color from light gray to a soft blue.",
    "image_urls": ["https://example.com/reference.jpg"],
    "resolution": "2K"
  }
}

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