# Real-ESRGAN Video - Core.Today AI API

> Video upscaling with Real-ESRGAN — enhance videos to FHD, 2K, or 4K frame by frame. The go-to open-source video upscaler for old footage and AI-generated clips.

- **Provider**: Real-ESRGAN
- **Model ID**: lucataco/real-esrgan-video
- **Category**: Video Generation
- **Credits**: 1280 per run (cost varies strongly with video length/resolution)
- **Speed**: Slow
- **Quality**: High

## Features
- Upscale to FHD / 2K / 4K
- Three Real-ESRGAN model variants (incl. anime)
- Frame-by-frame enhancement
- Great for AI-generated video cleanup

## Use Cases
- Upscaling AI-generated videos
- Old footage restoration
- Social clips to 4K masters
- Anime video enhancement

## API Endpoint

Base URL: https://api.core.today/v1
Create Prediction: POST /predictions
Get Status: GET /predictions/{job_id}

## Authentication
Header: X-API-Key: YOUR_API_KEY

## Input Parameters

### Required
- **video_path**: string - Input video to upscale

### Optional
- **resolution**: string (default: FHD) - Target output resolution
  Options: FHD, 2k, 4k
- **model**: string (default: RealESRGAN_x4plus) - Upscaling model variant (anime variant for animation)
  Options: RealESRGAN_x4plus, RealESRGAN_x4plus_anime_6B, realesr-animevideov3

## Examples

### AI Clip to 4K
Upscale a generated video clip to 4K
```json
{
  "model": "lucataco/real-esrgan-video",
  "input": {
    "video_path": "https://example.com/generated-clip.mp4",
    "model": "RealESRGAN_x4plus",
    "resolution": "4k"
  }
}
```

## Response Format
```json
{
  "job_id": "abc123",
  "status": "pending | processing | completed | failed",
  "result": "URL or data (when completed)"
}
```

## Usage Flow
1. POST /predictions with model and input -> receive job_id
2. GET /predictions/{job_id} -> poll until status is completed or failed
3. Result contains output URL(s)

## Tips
- Use the anime variants for animation — they preserve line art much better
- Processing time scales with video length and target resolution — keep clips short
- For single images, use the much cheaper Real-ESRGAN (6 credits)

## Documentation
https://replicate.com/lucataco/real-esrgan-video