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

# Introduction

> Media processing API for video, audio, image, and document transformations

# Welcome to MediAPI

MediAPI is a REST API that processes media files — video, audio, images, and documents — via simple HTTP calls. Submit a job with an input file and operations, and get the processed output back.

## What can you do?

<CardGroup cols={2}>
  <Card title="Video Processing" icon="video" href="/operations/video">
    Transcode, trim, resize, generate GIFs, HLS streaming, subtitles, and more
  </Card>

  <Card title="Audio Processing" icon="music" href="/operations/audio">
    Normalize loudness, extract audio, mix tracks, remove noise, transcribe
  </Card>

  <Card title="Image Processing" icon="image" href="/operations/image">
    Resize, crop, convert formats, watermark, blur, deep zoom tiles
  </Card>

  <Card title="Document Processing" icon="file-pdf" href="/operations/document">
    PDF split/merge/compress, DOCX to PDF, HTML to PDF, screenshots
  </Card>
</CardGroup>

## How it works

1. **Get an API key** from the [dashboard](https://app.ringbee.dev)
2. **Submit a job** with your input file URL and desired operations
3. **Poll for status** or receive a webhook when processing completes
4. **Download the result** via a presigned URL

```bash theme={null}
# Example: Resize an image to 800px wide
curl -X POST https://api.ringbee.dev/v1/jobs \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": "https://example.com/photo.jpg",
    "operations": [
      { "type": "image_resize", "params": { "width": 800 } }
    ]
  }'
```

## 67 Operations

MediAPI supports 67 media processing operations across video, audio, image, document, and metadata categories. All operations use the same simple job-based API.