API Documentation

Complete reference for the Media Service API

Overview

The Media Service API provides a complete REST interface for managing images and videos with folder organization, automatic image optimization, and video transcoding via Mux.

Base URL

http://localhost:3000/api

Key Features

  • API key authentication with rate limiting
  • Folder organization for images and videos
  • Image upload with automatic variant generation (WebP, AVIF, JPEG)
  • Video upload with 4K support via Mux
  • Bulk operations (upload, move, delete)
  • Advanced search, filtering, and pagination
  • R2 storage with Cloudflare CDN delivery

Getting Started

  1. Create an API key in the settings page
  2. Include the key in your API requests (see Authentication)
  3. Create folders to organize your media
  4. Start uploading images and videos!