# Hyperconvert API

> Media transformation API for images and videos. Remove backgrounds, resize, generate thumbnails, and create emoticon packs.

## Base URL
https://api.hyperconvert.media

## Authentication
Bearer token required: `Authorization: Bearer YOUR_API_KEY`

## Endpoints

### POST /api/v1/image/resize
Resize an image
Resize an image to specified dimensions with optional format conversion

### POST /api/v1/image/thumbnail
Generate thumbnail
Create an optimized thumbnail with preset or custom dimensions

### POST /api/v1/image/emoticon
Generate emoticon pack
Generate multiple sizes (16-256px) in PNG and WebP formats

### POST /api/v1/image/emoticon/zip
Download emoticon pack as ZIP
Generate emoticon pack and download as ZIP file with organized folders

### POST /api/v1/image/remove-background
Remove background from image
Remove background using automatic edge color detection or manual chromakey.
Returns PNG with transparency.


### POST /api/v1/image/detect-background-color
Detect background color
Analyze image edges to detect the dominant background color

### POST /api/v1/video/remove-background
Remove video background
Remove background from video using automatic edge color detection or manual chromakey.

**Processing Modes:**
- **Auto-detect**: Analyzes first frame edges to detect background color
- **Manual chroma

## SDKs & Packages

- **@hyperconvert/sdk**: TypeScript SDK for Node.js and browsers
  npm install @hyperconvert/sdk

- **@hyperconvert/react**: WebGL player for transparent videos (React/Next.js)
  npm install @hyperconvert/react

- **@hyperconvert/expo-native**: Native Metal player for transparent videos (Expo/React Native, iOS)
  npm install @hyperconvert/expo-native

- **HyperconvertVideo**: Swift Package for iOS/macOS with Metal rendering
  Swift Package Manager: https://github.com/hypersocialinc/hyperconvert.git

## Links

- Docs: https://api.hyperconvert.media/docs
- OpenAPI: https://api.hyperconvert.media/docs.json
- Playground: https://app.hyperconvert.media