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

# Media API

Domain: `https://media.enad.io`

## Overview

The Media API provides image processing capabilities including resizing, cropping, format conversion, and various transformation effects.

## Endpoints

### Image Processing

**GET** `/{app_id}/{filename}`

Process and transform images stored in R2 bucket with various options.

#### Path Parameters

| Parameter  | Type     | Required | Description                        |
| ---------- | -------- | -------- | ---------------------------------- |
| `app_id`   | `string` | Yes      | Application/tenant UUID identifier |
| `filename` | `string` | Yes      | Image filename in the bucket       |

#### Query Parameters

| Parameter   | Type      | Required | Default   | Description                                         |
| ----------- | --------- | -------- | --------- | --------------------------------------------------- |
| `width`     | `u32`     | No       | -         | Target width in pixels (1-5000)                     |
| `height`    | `u32`     | No       | -         | Target height in pixels (1-5000)                    |
| `quality`   | `u8`      | No       | `80`      | Image quality (0-100)                               |
| `format`    | `string`  | No       | original  | Output format: `webp`, `avif`, `png`, `jpeg`, `jpg` |
| `fit`       | `string`  | No       | `contain` | Resize mode (see Fit Modes below)                   |
| `blur`      | `f32`     | No       | -         | Blur intensity (0.0-100.0)                          |
| `crop_x`    | `i32`     | No       | -         | Horizontal crop offset in pixels                    |
| `crop_y`    | `i32`     | No       | -         | Vertical crop offset in pixels                      |
| `fill`      | `string`  | No       | -         | Background fill color (hex format: `#000000`)       |
| `bg_remove` | `boolean` | No       | -         | Remove background using machine learning            |

#### Fit Modes

* **`contain`** - Resize to fit within dimensions, maintaining aspect ratio
* **`cover`** - Scale to fill dimensions, cropping excess (centers crop unless `crop_x`/`crop_y` specified)
* **`scale-down`** - Only resize if image is larger than target dimensions
* **`crop`** - Scale and crop to exact dimensions
* **`pad`** - Resize to fit and pad remaining space with transparent background
* **`squeeze`** - Stretch/squash to exact dimensions, ignoring aspect ratio

#### Dimension Behavior

* If only `width` is provided: height is calculated to maintain aspect ratio
* If only `height` is provided: width is calculated to maintain aspect ratio
* If both are provided: behavior depends on `fit` mode
* If neither is provided: original dimensions are used

#### Examples

```bash theme={null}
# Resize to width 800, maintain aspect ratio
GET https://media.enad.io/{app_id}/photo.jpg?width=800

# Convert to WebP with quality 90
GET https://media.enad.io/{app_id}/photo.jpg?format=webp&quality=90

# Resize and crop to exact dimensions
GET https://media.enad.io/{app_id}/photo.jpg?width=1920&height=1080&fit=cover

# Add blur effect
GET https://media.enad.io/{app_id}/photo.jpg?width=800&blur=5.0

# Fill transparent areas with white
GET https://media.enad.io/{app_id}/photo.png?fill=%23FFFFFF

# Custom crop position
GET https://media.enad.io/{app_id}/photo.jpg?width=500&height=500&fit=cover&crop_x=100&crop_y=50
```

#### Response

* **Content-Type**: Varies based on output format
  * `image/png`
  * `image/jpeg`
  * `image/webp`
  * `image/avif`
* **Status Codes**:
  * `200 OK` - Success
  * `400 Bad Request` - Invalid parameters
  * `404 Not Found` - Image not found
  * `500 Internal Server Error` - Processing error

## Limits

* **Dimensions**: Maximum 5000x5000 pixels
* **Minimum Dimensions**: At least 1 pixel
* **Image Quality**: 0-100
* **Blur Range**: 0.0-100.0
* **URL**: Maximum 16 KB (typical HTTP limit)

## Error Responses

All errors return appropriate HTTP status codes with descriptive messages:

### 400 Bad Request

Returned when:

* Invalid dimensions (outside 1-5000 range)
* Invalid fit mode for given dimensions
* Invalid format specified
* Invalid hex color format
* Invalid blur value
* Crop offsets exceed image bounds

### 404 Not Found

Returned when:

* Requested image file doesn't exist in bucket

### 500 Internal Server Error

Returned when:

* Image processing fails
* Internal Server Error