[Integrations](https://spiral.ai/integrations) › [Instinct](https://spiral.ai/integrations/instinct) › [ByteDance Video Upscaler](https://spiral.ai/integrations/instinct/bytedance-video-upscaler)

# How to Use ByteDance Video Upscaler in Instinct

ByteDance Video Upscaler restores existing footage, with targeted processing for AI clips, compressed social videos, short dramas, and old films. It supports output up to 8K; proportional scaling has a separate 4K ceiling.

|  |  |
| --- | --- |
| Model | ByteDance Video Upscaler |
| Available through | fal |
| Category | Video |
| Price | Up to $0.5616 per run at the default inputs for 60 seconds of input. `target_resolution`: 1080p (default) $0.5616, 2k $1.1232, 4k $2.2464, 6k $4.4928, 8k $8.9856. |
| Returns | video |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with ByteDance Video Upscaler in Instinct

- Each morning, use ByteDance Video Upscaler on new compressed social videos in the review queue. Produce 1080p copies with processing for user-generated content.
- Every evening, use ByteDance Video Upscaler to prepare 4K review copies of newly approved AI clips with processing for generated content.
- Each week, use ByteDance Video Upscaler on selected archival excerpts with classic film processing. Queue the results for comparison with their originals.
- Each morning, use ByteDance Video Upscaler on approved short drama excerpts at 1080p with drama processing. Flag the results for facial-detail review.
- Every Friday, use ByteDance Video Upscaler to prepare approved grading candidates at 4K with Pro processing and 10-bit color.

## How to set up ByteDance Video Upscaler in Instinct

Pick the way that suits you. Each takes about two minutes.

### Use the Spiral skill

1. **Send Instinct this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use Spiral's MCP server

1. **Create an API key**: In the console, open API keys and create a key for Instinct. Copy it.

2. **Send Instinct this message**: Instinct reads Spiral's skill and asks for your API key.

```text
set up https://spiral.ai/SKILL.md
```

3. **Give Instinct the key**: When Instinct asks for the key, add it where Instinct keeps secrets, never in the chat itself.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run ByteDance Video Upscaler**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "fal",
    "model": "fal-ai/bytedance-upscaler/upscale/video",
    "input": {
      "video_url": "https://storage.googleapis.com/falserverless/example_inputs/bytedance_video_upscaler_input.mp4"
    }
  }'
```

Then paste one of the prompts above: Instinct finds ByteDance Video Upscaler on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/instinct

## ByteDance Video Upscaler tools and prices

- [Bytedance Upscaler Upscale Video](https://spiral.ai/tools/fal/fal-ai/bytedance-upscaler/upscale/video) (fal): Up to $0.5616 per run at the default inputs for 60 seconds of input. `target_resolution`: 1080p (default) $0.5616, 2k $1.1232, 4k $2.2464, 6k $4.4928, 8k $8.9856.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| target_resolution | 1080p, 2k, 4k, 6k, 8k | 1080p | The target resolution of the video to upscale. |
| target_fps | 24 to 120 | 30 | The target frame rate of the enhanced video in frames per second. |
| enhancement_preset | general, ugc, short_series, aigc, old_film | general | The enhancement preset optimized for specific video scenarios. 'general' is a general-purpose template, 'ugc' targets user-generated short videos, 'short_series' is for short dramas, 'aigc' is for AI-generated content, and 'old_film' is for classic film restoration. |
| enhancement_tier | fast, standard, pro | standard | The enhancement quality tier. 'fast' provides essential upscaling with good speed, 'standard' uses adaptive algorithms for better visual texture, 'pro' uses large-model restoration for cinematic quality (longer processing time), and 10 times the cost of `standard` and `fast`. |
| scale_ratio | 1.1 to 10 | — | The scaling ratio for the output video resolution. When set, overrides target_resolution and scales the input resolution by this factor (e.g., 2.0 doubles the resolution). Range: 1.1 to 10.0. Please note that this is valid only up to 4k resolution, and trying to scale beyond 4k will result in an error. (4k is defined as having atotal pixel count of 3840x2160). |
| fidelity | high, medium | high | The enhancement intensity. 'high' applies mild enhancement while keeping visual texture close to the source video. 'medium' provides a balanced image quality enhancement. |

## What can you do with ByteDance Video Upscaler in Instinct?

Prepare consistent enhancement candidates from incoming videos on a schedule. Route compressed clips, generated footage, drama scenes, and archival material to matching treatments for review.

### Clean up compressed social clips

Use UGC processing on reposted videos with visible compression blocks, blur, or noise.

### Finish generated video

Use AI content processing to turn low-resolution generated clips into 2K or 4K delivery candidates.

### Refine short drama close-ups

Apply short drama processing to soft facial features and textures, then review close-ups against the source.

### Restore archival film excerpts

Test classic film processing on passages with scratches, noise, and flicker before treating a longer restoration.

### Prepare higher-resolution video

Produce a 4K, 6K, or 8K candidate from existing footage, then inspect it at the intended viewing size.

### Prepare footage for color grading

Request Pro processing with 10-bit or 12-bit output when the downstream editing workflow calls for that color depth.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Instinct guides](https://spiral.ai/integrations/instinct)

## ByteDance Video Upscaler in other agents

- [Amp](https://spiral.ai/integrations/amp/bytedance-video-upscaler)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/bytedance-video-upscaler)
- [Claude](https://spiral.ai/integrations/claude-desktop/bytedance-video-upscaler)
- [Claude Code](https://spiral.ai/integrations/claude-code/bytedance-video-upscaler)
- [Cline](https://spiral.ai/integrations/cline/bytedance-video-upscaler)
- [Codex](https://spiral.ai/integrations/codex/bytedance-video-upscaler)
- [Cursor](https://spiral.ai/integrations/cursor/bytedance-video-upscaler)
- [Devin](https://spiral.ai/integrations/devin/bytedance-video-upscaler)
- [dots](https://spiral.ai/integrations/dots/bytedance-video-upscaler)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/bytedance-video-upscaler)
- [Gemini](https://spiral.ai/integrations/gemini/bytedance-video-upscaler)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/bytedance-video-upscaler)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/bytedance-video-upscaler)
- [goose](https://spiral.ai/integrations/goose/bytedance-video-upscaler)
- [Grok](https://spiral.ai/integrations/grok/bytedance-video-upscaler)
- [Grok Build](https://spiral.ai/integrations/grok-build/bytedance-video-upscaler)
- [Hermes](https://spiral.ai/integrations/hermes/bytedance-video-upscaler)
- [Manus](https://spiral.ai/integrations/manus/bytedance-video-upscaler)
- [Muse](https://spiral.ai/integrations/muse/bytedance-video-upscaler)
- [Muse Code](https://spiral.ai/integrations/muse-code/bytedance-video-upscaler)
- [n8n](https://spiral.ai/integrations/n8n/bytedance-video-upscaler)
- [Notion](https://spiral.ai/integrations/notion/bytedance-video-upscaler)
- [OpenClaw](https://spiral.ai/integrations/openclaw/bytedance-video-upscaler)
- [opencode](https://spiral.ai/integrations/opencode/bytedance-video-upscaler)
- [Perplexity](https://spiral.ai/integrations/perplexity/bytedance-video-upscaler)
- [Raycast](https://spiral.ai/integrations/raycast/bytedance-video-upscaler)
- [VS Code](https://spiral.ai/integrations/vscode/bytedance-video-upscaler)
- [Windsurf](https://spiral.ai/integrations/windsurf/bytedance-video-upscaler)
- [Zapier](https://spiral.ai/integrations/zapier/bytedance-video-upscaler)

## More Instinct guides

- [Bria Video Upscaling](https://spiral.ai/integrations/instinct/bria-video-upscaling)
- [CassetteAI Video Sound Effects Generator](https://spiral.ai/integrations/instinct/cassetteai-video-sound-effects-generator)
- [Bria Video Green Screen Despill](https://spiral.ai/integrations/instinct/bria-video-green-screen-despill)
- [DWPose Video](https://spiral.ai/integrations/instinct/dwpose-video)
- [Bria Video Eraser Prompt](https://spiral.ai/integrations/instinct/bria-video-eraser-prompt)
- [Depth Anything Video](https://spiral.ai/integrations/instinct/depth-anything-video)

## Questions about ByteDance Video Upscaler in Instinct

**Can Instinct use ByteDance Video Upscaler?**

Yes. Add Spiral to Instinct as an MCP server, and Instinct can find and run ByteDance Video Upscaler like any built-in tool.

**How much does ByteDance Video Upscaler cost in Instinct?**

Up to $0.5616 per run at the default inputs for 60 seconds of input. `target_resolution`: 1080p (default) $0.5616, 2k $1.1232, 4k $2.2464, 6k $4.4928, 8k $8.9856. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Instinct plan is separate.

**Do I need a fal account to use ByteDance Video Upscaler in Instinct?**

You need no fal account. Instinct uses one Spiral API key for every tool, and Spiral runs ByteDance Video Upscaler on its own fal account.

**How long does it take to set up ByteDance Video Upscaler in Instinct?**

About two minutes: create an API key, then send Instinct this message, then give Instinct the key.

**Does Instinct wait while ByteDance Video Upscaler runs?**

ByteDance Video Upscaler runs in the background. Instinct starts the run, checks on it and gives you the video when it's ready.

**What footage is ByteDance Video Upscaler useful for?**

It has targeted processing for compressed social videos, low-resolution AI clips, short dramas, and classic films. Match the processing to the source: compression blocks, generated textures, faces, and film damage call for different treatment.

**Can ByteDance Video Upscaler output 8K?**

Yes, resolution targets reach 8K. Proportional scaling has a separate 4K ceiling, so use a resolution target for output above 4K.

**How do I keep the result close to the original?**

Use high fidelity for mild enhancement that keeps visual texture close to the source. Compare a sample against the original before processing the full video.

**When should I choose Fast, Standard, or Pro?**

Use Fast for basic enhancement and Standard as a starting point for texture refinement. Test Pro when you need large-model restoration, and choose it when requesting 10-bit or 12-bit output.

**Can ByteDance Video Upscaler restore old film?**

Classic film processing targets noise, scratches, and flicker. Test a damaged passage first and compare the result with the original before applying it across an archive.

