# GPT Image 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/gpt-image/gpt-image-api

## Model & Pricing

gpt-image-1 bills by output tokens at $40 / 1M output tokens.
Estimated per-image cost (docs cost matrix):

- 1024x1024: low ~$0.011 / medium ~$0.042 / high ~$0.167
- 1024x1536: low ~$0.016 / medium ~$0.063 / high ~$0.250
- 1536x1024: low ~$0.016 / medium ~$0.063 / high ~$0.250

## Create Task (async)

POST /api/v1/images/generations/async
{
  "model": "gpt-image-1",
  "prompt": "A steaming bowl of ramen viewed from above, cinematic food photography",
  "size": "1024x1024",
  "quality": "medium"
}

quality: "low" | "medium" | "high"
size: "1024x1024" | "1024x1536" | "1536x1024"
Image edits: POST /api/v1/images/edits/async (multipart: image + model + prompt + size + quality)

## Get Task Result

GET /api/v1/task/{task_id}

Status: "pending" → "processing" → "completed" or "failed"
Image: response.data.output.data[0].b64_json (base64-encoded PNG)
Billing: response.data.output.usage.output_tokens × $40 / 1M tokens

## Quick Start

1. Get API key: https://piapi.ai/workspace/key
2. Top up: https://piapi.ai/workspace/billing
3. POST /api/v1/images/generations/async
4. Poll GET /api/v1/task/{task_id} until "completed"
5. Decode the image from response.data.output.data[0].b64_json