> ## Documentation Index
> Fetch the complete documentation index at: https://docs.inquantum.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Image Generation

> Create images through the AI Gateway image-generation route.

`POST /v1/images/generations` creates images through an OpenAI-compatible request shape.

## Endpoint URL

```text theme={null}
https://api.inquantum.ai/v1/images/generations
```

## Example Request

```bash theme={null}
curl https://api.inquantum.ai/v1/images/generations \
  -H "Authorization: Bearer $PLANCK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "A clean product rendering of a small desk lamp",
    "size": "1024x1024"
  }'
```

## BYOK

To use your own provider key, keep the Planck API key in `Authorization` and send the provider key separately:

```bash theme={null}
X-Provider-Key: $PROVIDER_API_KEY
```

## Notes

* Image generation is usage-bearing and should flow through gateway billing and logging.
* Supported models depend on the model registry and provider availability.

See [Image Generation](/gateway/image-generation) for the recommended SDK example.