[Integrations](https://spiral.ai/integrations) › [Muse Code](https://spiral.ai/integrations/muse-code) › [ByteDance Video Upscaler](https://spiral.ai/integrations/muse-code/bytedance-video-upscaler)

# How to Use ByteDance Video Upscaler in Muse Code

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, no API key |

## Prompts to try with ByteDance Video Upscaler in Muse Code

- Use ByteDance Video Upscaler on the project's compressed social clips at 1080p with UGC processing. Save review copies beside the originals.
- Find the project's low-resolution generated videos and use ByteDance Video Upscaler to make 4K review copies with AI content processing.
- Use ByteDance Video Upscaler on a sample from the project's drama footage with short drama processing. Prepare a comparison focused on facial texture.
- Use ByteDance Video Upscaler to test classic film processing on a scratched archival excerpt in the project. Keep the original for comparison.
- Use ByteDance Video Upscaler to prepare a 4K, 10-bit review copy of the project's selected video with Pro processing.

## How to set up ByteDance Video Upscaler in Muse Code

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

### Use Spiral's MCP server

1. **Install Muse Code**

```bash
curl -fsSL https://dev.meta.ai/install.sh | bash
```

2. **Ask Muse to add the server**: Start `muse` and ask:

```text
Add the Spiral MCP server at https://api.spiral.ai/mcp
```

3. **Sign in**: In your terminal, run:

```bash
muse mcp login spiral
```

### Use the Spiral skill

1. **Send Muse Code 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 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: Muse Code finds ByteDance Video Upscaler on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/muse-code

## 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 Muse Code?

Prepare existing project videos for higher-resolution delivery and restoration review. Use source-aware processing and compare samples before replacing production assets.

### 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 Muse Code guides](https://spiral.ai/integrations/muse-code)

## 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)
- [Instinct](https://spiral.ai/integrations/instinct/bytedance-video-upscaler)
- [Manus](https://spiral.ai/integrations/manus/bytedance-video-upscaler)
- [Muse](https://spiral.ai/integrations/muse/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 Muse Code guides

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

## Questions about ByteDance Video Upscaler in Muse Code

**Can Muse Code use ByteDance Video Upscaler?**

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

**How much does ByteDance Video Upscaler cost in Muse Code?**

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 Muse Code plan is separate.

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

No. Spiral runs ByteDance Video Upscaler on its own fal account. You sign in to Spiral once and never paste a key.

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

About two minutes: install Muse Code, then ask Muse to add the server, then sign in.

**Does Muse Code wait while ByteDance Video Upscaler runs?**

ByteDance Video Upscaler runs in the background. Muse Code 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.

