# Upscale image

> **🔨 In Development**
This section is currently being developed and may change.


Increase the resolution and fidelity of your source images using Freddy upscaling models.

## Authentication

- `Authorization: Bearer $FREDDY_API_KEY`
[Get your API key](https://freddy-hub.aitronos.com/freddy/api)


## Request body

| Field | Type | Required | Description |
|  --- | --- | --- | --- |
| `image_url` | string | **Yes** | Public URL or base64 string for the input image. |
| `scale` | number | No | Upscaling factor (`2` or `4`). Default: `2`. |
| `format` | string | No | Output format (`png`, `jpeg`, `webp`). Default: `png`. |


## Returns

JSON object containing upscaled image metadata and a download URL.


```json
{
  "data": [
    {
      "url": "https://api.freddy.aitronos.com/upscaled-images/img_abc123.png",
      "original_size": {
        "width": 512,
        "height": 512
      },
      "upscaled_size": {
        "width": 1024,
        "height": 1024
      }
    }
  ]
}
```

Request (curl)

```bash
curl -X POST "https://api.freddy.aitronos.com/v1/images/upscale" \
  -H "Authorization: Bearer $FREDDY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/image.jpg",
    "scale": 2,
    "format": "png"
  }'
```

Python

```python
import os
import requests

api_key = os.environ["FREDDY_API_KEY"]

response = requests.post(
    "https://api.freddy.aitronos.com/v1/images/upscale",
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json"
    },
    json={
        "image_url": "https://example.com/image.jpg",
        "scale": 2,
        "format": "png"
    }
)

response.raise_for_status()
upscaled = response.json()
```

JavaScript

```javascript
const response = await fetch(
  "https://api.freddy.aitronos.com/v1/images/upscale",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.FREDDY_API_KEY}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      image_url: "https://example.com/image.jpg",
      scale: 2,
      format: "png"
    })
  }
);

if (!response.ok) {
  throw new Error("Failed to upscale image");
}

const payload = await response.json();
```

## Related resources

- [Image object](/docs/api-reference/images/objects/image-object)
- [Generate image](/docs/api-reference/images/generate)
- [Cleanup image](/docs/api-reference/images/cleanup)
- [Remove background](/docs/api-reference/images/remove-background)