Name: Video Upscaler – Enhance Video to 4K | $0.03/call | API.market
Brand: magicapi
SKU: api-magicapi-video-upscaler-runwayml-upscale-v1
Availability: InStock
Author: API Market

Shashank Agarwal

# 🔺 High-Resolution Video Upscaler API (runwayml/upscale-v1)

## Overview
The High-Resolution Video Upscaler API (runwayml/upscale-v1) enables users to upscale videos by 4x, delivering stunning 4K resolution outputs with remarkable quality and speed. This powerful AI-driven tool streamlines the process of enhancing video quality, making it ideal for applications in video production, entertainment, and numerous other industries.

## Features
- **4x Video Upscaling**: Enhance videos by scaling them up to four times their original resolution.
- **4K Output**: Achieve a maximum resolution of 4096 pixels on the longer side.
- **Superior Quality**: Maintain exceptional video clarity and detail during the upscaling process.
- **Fast Processing**: Efficient algorithms ensure quick turnaround times for processing video requests.
- **Asynchronous Processing**: Handle large video files with an efficient asynchronous prediction system.

## Use Cases
1. **Film Restoration**: Restore and upscale classic movies from archival footage to modern 4K quality.
2. **Gaming**: Enhance in-game cutscenes and trailers for a more immersive visual experience.
3. **Streaming Services**: Improve the quality of older video content in streaming libraries to meet current 4K standards.
4. **Advertising**: Upscale advertisement videos to 4K resolution for high-quality displays and better viewer engagement.
5. **Content Creation**: Support content creators on platforms like YouTube and Vimeo with HD and 4K video output.

## Visual Examples
### Input Video
![Low-Resolution Video](https://blog.api.market/wp-content/uploads/2026/01/A_man_says_api-market.mp4)

### Output Video
![Upscaled 4K Video](https://blog.api.market/wp-content/uploads/2026/01/A-man-says-output-api-market.mp4)

## Pricing
- **Pay As You Go (PAYG)**: $0.0250 per second of output video generated.
- **Free GET Requests**: Checking prediction status with the GET request is free.
- **No Subscription Fees**: Simple per-call pricing without any monthly subscription fees or usage caps.

## API Documentation

### Base URL
```plaintext
https://prod.api.market/api/v1/magicapi/video-upscaler-runwayml-upscale-v1
```

### Authentication
Include your API key in the request header:
```plaintext
x-api-market-key: YOUR_API_MARKET_KEY
```

### Asynchronous Processing
**IMPORTANT**: The API uses asynchronous processing for predictions. The typical flow is:
1. Submit a prediction request to the POST endpoint.
2. Receive a prediction ID in the response.
3. Poll the GET endpoint with the prediction ID to check the status.
4. Continue polling until the prediction is complete.

### Endpoints

#### Create Prediction
**POST /predictions**

Create a prediction by submitting a video to be upscaled.

##### Request:
```bash
curl -X POST "https://prod.api.market/api/v1/magicapi/video-upscaler-runwayml-upscale-v1/predictions" \
  -H "Content-Type: application/json" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY" \
  -d '{
    "version": "079ac0e1e0f92616024bc63f2fd60142fc9967c7dcc3fce274875f60e10c958e",
    "input": {
      "video": "https://blog.api.market/wp-content/uploads/2026/01/A_man_says_api-market.mp4"
    }
  }'
```

##### Response:
```json
{
  "id": "ufawqhfynnddngldkgtslldrkq",
  "version": "079ac0e1e0f92616024bc63f2fd60142fc9967c7dcc3fce274875f60e10c958e",
  "status": "starting",
  "created_at": "2026-01-29T19:35:21.743Z"
}
```

#### Check Prediction Status
**GET /predictions/{id}**

Get the status and results of a previously created prediction.

##### Request:
```bash
curl -X GET "https://prod.api.market/api/v1/magicapi/video-upscaler-runwayml-upscale-v1/predictions/ufawqhfynnddngldkgtslldrkq" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

##### Response:
```json
{
  "id": "ufawqhfynnddngldkgtslldrkq",
  "status": "succeeded",
  "output": "https://blog.api.market/wp-content/uploads/2026/01/A-man-says-output-api-market.mp4",
  "created_at": "2023-01-01T12:00:00.000Z",
  "started_at": "2023-01-01T12:00:05.000Z",
  "completed_at": "2023-01-01T12:01:00.000Z"
}
```

## Status Codes
- **200 OK**: Request successful
- **201 Created**: Resource successfully created
- **400 Bad Request**: Invalid input parameters or malformed request
- **401 Unauthorized**: Missing or invalid API key
- **403 Forbidden**: Valid API key but insufficient permissions
- **404 Not Found**: Resource not found
- **429 Too Many Requests**: Rate limit exceeded
- **500 Internal Server Error**: Server-side error
- **503 Service Unavailable**: Service temporarily unavailable

## Rate Limits
The API imposes rate limits to prevent abuse. When rate limits are exceeded, the response will include a `429 Too Many Requests` status code. Implement retry logic to handle rate limit errors.

## Error Handling
Provide detailed guidance on error handling best practices:
- Understand error response messages and status codes.
- Common errors include 400 (Bad Request) and 401 (Unauthorized).
- Implement retry strategies for retries when facing transient errors like 429 (Too Many Requests).

Example Error Response:
```json
{
  "error": {
    "code": "invalid_parameter",
    "message": "The parameter 'image' is required",
    "status": 400
  }
}
```

## Implementation Guide

### Example Code

#### JavaScript
```javascript
const apiKey = "YOUR_API_MARKET_KEY";
const baseUrl = "https://prod.api.market/api/v1/magicapi/video-upscaler-runwayml-upscale-v1";

async function createAndWaitForPrediction(inputData) {
  try {
    const response = await fetch(`${baseUrl}/predictions`, {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        "x-api-market-key": apiKey
      },
      body: JSON.stringify({ version: "079ac0e1e0f92616024bc63f2fd60142fc9967c7dcc3fce274875f60e10c958e", input: inputData })
    });
    
    if (!response.ok) {
      throw new Error(`API error: ${response.status} ${response.statusText}`);
    }
    
    const prediction = await response.json();
    const predictionId = prediction.id;
    
    return await pollForResults(predictionId);
  } catch (error) {
    console.error("Error:", error);
    throw error;
  }
}

function delay(ms) {
  return new Promise(resolve => setTimeout(resolve, ms));
}

async function pollForResults(predictionId) {
  const MAX_TIMEOUT = 600000;
  const POLL_INTERVAL = 1000;
  
  const startTime = Date.now();
  
  while (Date.now() - startTime < MAX_TIMEOUT) {
    const response = await fetch(`${baseUrl}/predictions/${predictionId}`, {
      headers: {
        "x-api-market-key": apiKey
      }
    });
    
    if (!response.ok) {
      throw new Error(`API error: ${response.status} ${response.statusText}`);
    }
    
    const prediction = await response.json();
    
    if (prediction.status === "succeeded") {
      return prediction.output;
    }
    
    if (prediction.status === "failed") {
      throw new Error(`Prediction failed: ${prediction.error || "Unknown error"}`);
    }
    
    await delay(POLL_INTERVAL);
  }
  
  throw new Error("Prediction timed out after 10 minutes");
}
```

#### Python
```python
import requests
import time

API_KEY = "YOUR_API_MARKET_KEY"
BASE_URL = "https://prod.api.market/api/v1/magicapi/video-upscaler-runwayml-upscale-v1"

def create_and_wait_for_prediction(input_data):
    headers = {
        "Content-Type": "application/json",
        "x-api-market-key": API_KEY
    }
    
    response = requests.post(
        f"{BASE_URL}/predictions",
        headers=headers,
        json={"version": "079ac0e1e0f92616024bc63f2fd60142fc9967c7dcc3fce274875f60e10c958e", "input": input_data}
    )
    
    if response.status_code != 200:
        raise Exception(f"API error: {response.status_code} {response.text}")
    
    prediction = response.json()
    prediction_id = prediction["id"]
    
    return poll_for_results(prediction_id)

def poll_for_results(prediction_id):
    MAX_TIMEOUT = 600
    POLL_INTERVAL = 1
    
    headers = {"x-api-market-key": API_KEY}
    start_time = time.time()
    
    while time.time() - start_time < MAX_TIMEOUT:
        response = requests.get(
            f"{BASE_URL}/predictions/{prediction_id}",
            headers=headers
        )
        
        if response.status_code != 200:
            raise Exception(f"API error: {response.status_code} {response.text}")
        
        prediction = response.json()
        
        if prediction["status"] == "succeeded":
            return prediction["output"]
        
        if prediction["status"] == "failed":
            error_msg = prediction.get("error", "Unknown error")
            raise Exception(f"Prediction failed: {error_msg}")
        
        time.sleep(POLL_INTERVAL)
    
    raise Exception("Prediction timed out after 10 minutes")
```

#### cURL
```bash
# Create a prediction
curl -X POST "https://prod.api.market/api/v1/magicapi/video-upscaler-runwayml-upscale-v1/predictions" \
  -H "Content-Type: application/json" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY" \
  -d '{
    "version": "079ac0e1e0f92616024bc63f2fd60142fc9967c7dcc3fce274875f60e10c958e",
    "input": {
      "video": "https://example.com/image.jpg"
    }
  }'

# Response will contain a prediction ID like:
# {"id": "abcd1234", "status": "starting"}

# Check prediction status (replace abcd1234 with the actual ID)
curl -X GET "https://prod.api.market/api/v1/magicapi/video-upscaler-runwayml-upscale-v1/predictions/abcd1234" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY"

# Note: You need to repeatedly poll this endpoint manually until status is "succeeded"
```

### Performance Optimization
- Batch process videos to minimize API calls.
- Optimize input video size and duration to reduce processing time.
- Implement efficient error handling to retry only on transient errors.

## FAQ
### How do I use the API?
Refer to the provided example code and implementation guide for details on how to use the API.

### What file formats are supported?
The API supports common video file formats such as MP4.

### How long does processing take?
Processing time varies depending on the video size and complexity. The maximum allowed time is 10 minutes.

## Contact Us
If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello[at]api.market.

Upscale videos by 4x to 4K resolution with AI. Maintain exceptional clarity and detail with fast processing. From $0.03/call. Try it free on API.market.