# Image API
> Inspect image metadata (dimensions, format, size, colour space, transparency) and resize or convert images between JPEG, PNG, WebP and AVIF straight from a URL. Perfect for thumbnails, format optimisation and on-the-fly image transforms.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/image-api/..."
```

## Pricing
- **Free** (Free) — 750 calls/Mo, 2 req/s
- **Basic** ($7/Mo) — 25,000 calls/Mo, 8 req/s
- **Pro** ($24/Mo) — 120,000 calls/Mo, 25 req/s
- **Mega** ($59/Mo) — 500,000 calls/Mo, 60 req/s

## Endpoints

### Image

#### `GET /v1/file` — Resize/convert (raw image)

**Parameters:**
- `url` (query, required, string) — Image URL Example: `https://upload.wikimedia.org/wikipedia/commons/a/a9/Example.jpg`
- `width` (query, optional, string) — Target width 1-4000 Example: `200`
- `height` (query, optional, string) — Target height 1-4000
- `format` (query, optional, string) — jpeg|png|webp|avif

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/image-api/v1/file?url=https%3A%2F%2Fupload.wikimedia.org%2Fwikipedia%2Fcommons%2Fa%2Fa9%2FExample.jpg&width=200"
```

#### `GET /v1/info` — Image metadata

**Parameters:**
- `url` (query, required, string) — Image URL Example: `https://upload.wikimedia.org/wikipedia/commons/a/a9/Example.jpg`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/image-api/v1/info?url=https%3A%2F%2Fupload.wikimedia.org%2Fwikipedia%2Fcommons%2Fa%2Fa9%2FExample.jpg"
```

**Response:**
```json
{
    "data": {
        "url": "https://upload.wikimedia.org/wikipedia/commons/a/a9/Example.jpg",
        "width": 172,
        "format": "jpeg",
        "height": 178,
        "density": 100,
        "channels": 3,
        "has_alpha": false,
        "size_bytes": 9022,
        "color_space": "srgb",
        "orientation": null
    },
    "meta": {
        "timestamp": "2026-05-30T01:04:59.939Z",
        "request_id": "1e7e6920-f3a5-4084-b5a7-857ef40d63d2"
    },
    "status": "ok",
    "message": "Image info retrieved successfully",
    "success": true
}
```

#### `GET /v1/resize` — Resize/convert (base64 JSON)

**Parameters:**
- `url` (query, required, string) — Image URL Example: `https://upload.wikimedia.org/wikipedia/commons/a/a9/Example.jpg`
- `width` (query, optional, string) — Target width 1-4000 Example: `200`
- `height` (query, optional, string) — Target height 1-4000
- `format` (query, optional, string) — jpeg|png|webp|avif
- `fit` (query, optional, string) — inside|cover|contain|fill|outside

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/image-api/v1/resize?url=https%3A%2F%2Fupload.wikimedia.org%2Fwikipedia%2Fcommons%2Fa%2Fa9%2FExample.jpg&width=200"
```

**Response:**
```json
{
    "data": {
        "bytes": 5109,
        "image": "data:image/jpeg;base64,/9j/2wBDAAYEBQYFBAYGBQYHBwYIChAKCgkJChQODwwQFxQYGBcUFhYaHSUfGhsjHBYWICwgIyYnKSopGR8tMC0oMCUoKSj/2wBDAQcHBwoIChMKChMoGhYaKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCj/wAARCADPAMgDASIAAhEBAxEB/8QAHAABAAMBAQEBAQAAAAAAAAAAAAYHCAUDBAIB/8QAOBAAAQMDAgQEAgkDBQEAAAAAAQACAwQFBgcREhMhUSIxQWEycQgUFSNCUoHB0RYzYkORseHxof/EABoBAQACAwEAAAAAAAAAAAAAAAADBAIFBgH/xAArEQACAgIBBAEEAQQDAAAAAAAAAQIDBBExBRIhQSIUI1FhExUygaFDwdH/2gAMAwEAAhEDEQA/ANMIiIAiIgCIiAIiIAiIgCIiAIiIAiIgCIiAIiIAiIgCIiAIiIAiIgCIovn2ZW/D7S6pq3B9S4EQwA+J7v4XkmorbJKqpWyUILbZ9GXZbacUpY5rtPwcxwa1jerj7gLs0NXT19HFVUczJqeVocyRh3BCxZlOQ3DJrtLX3OUve4+Bn4Y2/lAUw0m1HqMSrG0de581mld42b7mIn8Tf3HqqkcrctPg6C7oEoUKUXuftGqkXhQ1lPX0cVVRTMmp5W8THsO4IXurm98HOSTi9MIiIeBERAEREAREQBERAEREAREQBERAEREARF/HhxY4MOziDsT5boCLagZpQYdaXVFU4PqnjaCnB8Tz/HusnZRkFfkt2lr7nKXyOPhZv4Yx6ABd3Vmkv9Ll9Sclc58ryTBIP7bo9+nCvTSXGKDJ8lbBc6lkcMfj5ROxk9lrrZysl2nbdPxacHH+ofl65ONg9PaqrJqOK/ymKhc7xEDzPY+ytbVrSyL6p9u4lEHRBnFNTR9Q5v52/uF8esGln2Y195xuFxpQN5qZvUs/yHsvPR3U19tlis19kL6N54YpXdSw9j7JGKj9uaMbr53pZeLLeuUcLSfUeoxKtFFXufNZ5XeNnmYT+Zv7hajoauCvo4aqjlbNTzND2Padw4FVrfdH7Ld8qgu8b+RRyHmVFKwbCU+YI7b+qsymgipaeKCmjbHDE0MYxo2DQPRWqYzj4lwaHql+Pe1ZUtSfJ6oiKc1IUUzLJvs6kqqS0PhnvgiMkdMXDiI77euy4+qeolLidE6npHNmuso8EYPwe5VNafY7d8tyB1/uFZLTU0D+dLWudwncddmlV7LfPbHk3GH07cHfd4iuP2XfpPl9ZlVmk+1KR8NbTO4JH8GzJPcdj3CnKhWG5zj16ulVabY9sVRC4loIDRN3c3upqpYPa52UMuDja/j2/oIiLMrBERAEREAREQBERAEREAREQHBzTFbfltmk
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/image-api
OpenAPI spec: https://www.oanor.com/api/image-api/openapi.json