How to Use ByteDance Video Upscaler in Gemini
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.
Prompts to try with ByteDance Video Upscaler in Gemini
Copy an example into Gemini, or ask in your own words.
Use ByteDance Video Upscaler to clean up this compressed social video at 1080p. Choose processing for user-generated clips and keep the texture close to the original.
Use ByteDance Video Upscaler to upscale this AI-generated clip to 4K with processing designed for generated content.
Use ByteDance Video Upscaler on this drama excerpt at 1080p with processing for short dramas. Help me compare facial texture with the original.
Use ByteDance Video Upscaler to test classic film restoration on this old clip. Focus the review on scratches, noise, and flicker.
Use ByteDance Video Upscaler to make a 4K, 10-bit copy of this video with Pro processing for my editing workflow.
How to set up ByteDance Video Upscaler in Gemini
Pick the way that suits you. Each takes about two minutes.
Use the Gemini connector
- Open Connected Apps
On your computer, go to gemini.google.com. At the bottom, click Settings › Connected Apps. If you don't see Connected Apps, click Personal Intelligence first, then Connected Apps.
- Add Spiral as a custom app
Under Custom apps, click Add a custom app and paste this MCP server URL:
https://api.spiral.ai/mcp
- Sign in to Spiral and approve
Follow the on-screen instructions. Spiral opens: sign in, pick the organization and click Authorize. No API key.
Use the Spiral skill
- Send Gemini this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run ByteDance Video Upscaler
One request; the result comes back by polling or a webhook.
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: Gemini finds ByteDance Video Upscaler on Spiral, shows the price and runs it.
ByteDance Video Upscaler providers and prices
Spiral runs ByteDance Video Upscaler through fal. Open a card for today's price, with every fee included.
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
ByteDance Video Upscaler works from your video URL. Ask Gemini for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Target resolution | 1080p, 2k, 4k, 6k, or 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, or 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, or 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 |
| 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 or 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. |
| Bit depth | 8, 10, or 12 | 8 | The color bit depth of the output video. 10-bit and 12-bit output require the Pro enhancement tier. |
Every API field of Bytedance Upscaler Upscale Video is on its tool page: open its card above.
What can you do with ByteDance Video Upscaler in Gemini?
Turn an existing video into a higher-resolution review copy or test a restoration treatment. Describe the footage and its main defect so the enhancement matches the source.
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.
More on ByteDance Video Upscaler and Gemini
Overview
ByteDance Video Upscaler in other agents
Questions about ByteDance Video Upscaler in Gemini
Can Gemini use ByteDance Video Upscaler?
Yes. Add Spiral to Gemini as an MCP server, and Gemini can find and run ByteDance Video Upscaler like any built-in tool.
How much does ByteDance Video Upscaler cost in Gemini?
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 Gemini plan is separate.
Do I need a fal account to use ByteDance Video Upscaler in Gemini?
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 Gemini?
About two minutes: open Connected Apps, then add Spiral as a custom app, then sign in to Spiral and approve.
Does Gemini wait while ByteDance Video Upscaler runs?
ByteDance Video Upscaler runs in the background. Gemini 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.
Start using ByteDance Video Upscaler in Gemini
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Gemini:
set up https://spiral.ai/SKILL.md


