fal-upscale

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

fal.ai Upscale

fal.ai 分辨率提升工具

Upscale and enhance image resolution using state-of-the-art AI models.

利用最先进的AI模型提升并增强图像与视频的分辨率。

How It Works

工作原理

User provides image URL and optional scale factor
Script selects appropriate upscaling model
Sends request to fal.ai API
Returns upscaled image URL

用户提供图像URL及可选的放大倍数
脚本选择合适的放大模型
向fal.ai API发送请求
返回提升分辨率后的图像URL

Image Upscale Models

图像放大模型

Model	Scale	Best For
`fal-ai/aura-sr`	4x	General upscaling, fast
`fal-ai/clarity-upscaler`	2-4x	Detail preservation
`fal-ai/creative-upscaler`	2-4x	Creative enhancement

模型	放大倍数	适用场景
`fal-ai/aura-sr`	4倍	通用图像放大，速度快
`fal-ai/clarity-upscaler`	2-4倍	细节保留
`fal-ai/creative-upscaler`	2-4倍	创意增强

Video Upscale Models

视频放大模型

Model	Notes
`fal-ai/video-upscaler`	General purpose
`fal-ai/topaz/upscale/video`	Premium quality
`fal-ai/bria/video/increase-resolution`	Fast
`fal-ai/flashvsr`	Real-time
`fal-ai/seedvr/upscale/video`	High fidelity
`fal-ai/bytedance-upscaler`	Good balance
`fal-ai/simalabs/sima-video-upscaler-lite`	Lightweight

模型	说明
`fal-ai/video-upscaler`	通用型
`fal-ai/topaz/upscale/video`	顶级画质
`fal-ai/bria/video/increase-resolution`	速度快
`fal-ai/flashvsr`	实时处理
`fal-ai/seedvr/upscale/video`	高保真
`fal-ai/bytedance-upscaler`	性能与画质平衡
`fal-ai/simalabs/sima-video-upscaler-lite`	轻量型

Usage

使用方法

bash

bash /mnt/skills/user/fal-upscale/scripts/upscale.sh [options]

Arguments:

```
--image-url
```
- URL of image to upscale (required)
```
--model
```
- Model ID (defaults to
```
fal-ai/aura-sr
```
)
```
--scale
```
- Upscale factor: 2 or 4 (default: 4)

Examples:

bash

undefined

bash

bash /mnt/skills/user/fal-upscale/scripts/upscale.sh [options]

参数说明:

```
--image-url
```
- 待放大图像的URL（必填）
```
--model
```
- 模型ID（默认值为
```
fal-ai/aura-sr
```
）
```
--scale
```
- 放大倍数：2或4（默认值：4）

示例:

bash

undefined

Image upscale with AuraSR (4x, fast)

使用AuraSR进行图像放大（4倍，速度快）

bash /mnt/skills/user/fal-upscale/scripts/upscale.sh
--image-url "https://example.com/image.jpg"

Image upscale with Clarity (detail preservation)

使用Clarity模型进行图像放大（保留细节）

bash /mnt/skills/user/fal-upscale/scripts/upscale.sh
--image-url "https://example.com/image.jpg"
--model "fal-ai/clarity-upscaler"
--scale 2

Video upscale (general purpose)

使用通用型模型进行视频放大

bash /mnt/skills/user/fal-upscale/scripts/upscale.sh
--video-url "https://example.com/video.mp4"
--model "fal-ai/video-upscaler"

Video upscale (premium quality)

使用顶级画质模型进行视频放大

bash /mnt/skills/user/fal-upscale/scripts/upscale.sh
--video-url "https://example.com/video.mp4"
--model "fal-ai/topaz/upscale/video"

undefined

bash /mnt/skills/user/fal-upscale/scripts/upscale.sh
--video-url "https://example.com/video.mp4"
--model "fal-ai/topaz/upscale/video"

undefined

MCP Tool Alternative

MCP工具替代方案

If MCP tools are available, prefer using:

mcp__fal-ai__generate({
  modelId: "fal-ai/aura-sr",
  input: {
    image_url: "https://example.com/image.jpg"
  }
})

若MCP工具可用，优先使用以下方式：

mcp__fal-ai__generate({
  modelId: "fal-ai/aura-sr",
  input: {
    image_url: "https://example.com/image.jpg"
  }
})

Output

输出示例

Upscaling with fal-ai/aura-sr...
Upscale complete!

Image URL: https://v3.fal.media/files/abc123/upscaled.png
Original: 512x512
Upscaled: 2048x2048

JSON output:

json

{
  "image": {
    "url": "https://v3.fal.media/files/abc123/upscaled.png",
    "width": 2048,
    "height": 2048
  }
}

正在使用fal-ai/aura-sr进行放大处理...
放大完成！

图像URL: https://v3.fal.media/files/abc123/upscaled.png
原尺寸: 512x512
放大后尺寸: 2048x2048

JSON格式输出:

json

{
  "image": {
    "url": "https://v3.fal.media/files/abc123/upscaled.png",
    "width": 2048,
    "height": 2048
  }
}

Present Results to User

向用户展示结果示例

Here's your upscaled image:

![Upscaled Image](https://v3.fal.media/files/...)

• 512×512 → 2048×2048 (4x)

这是您提升分辨率后的图像：

![提升分辨率后的图像](https://v3.fal.media/files/...)

• 原尺寸512×512 → 放大后2048×2048（4倍）

Model Selection Guide

模型选择指南

AuraSR (

fal-ai/aura-sr

)

Best for: Quick upscaling, general images
Speed: ~2 seconds
Fixed 4x scale

Clarity Upscaler (

fal-ai/clarity-upscaler

)

Best for: Preserving fine details
Speed: ~5 seconds
Configurable scale (2x or 4x)

Creative Upscaler (

fal-ai/creative-upscaler

)

Best for: Adding artistic detail
Speed: ~10 seconds
Enhances while upscaling

AuraSR (

fal-ai/aura-sr

)

适用场景：快速放大、通用图像
处理速度：约2秒
固定4倍放大

Clarity Upscaler (

fal-ai/clarity-upscaler

)

适用场景：保留精细细节
处理速度：约5秒
可配置放大倍数（2倍或4倍）

Creative Upscaler (

fal-ai/creative-upscaler

)

适用场景：添加艺术化细节
处理速度：约10秒
放大同时增强图像创意效果

Troubleshooting

故障排查

API Key Error

API密钥错误

Error: FAL_KEY environment variable not set

To fix:
1. Get your API key from https://fal.ai/dashboard/keys
2. Set: export FAL_KEY=your_key_here

错误：未设置FAL_KEY环境变量

修复方法：
1. 前往https://fal.ai/dashboard/keys获取您的API密钥
2. 设置环境变量：export FAL_KEY=您的密钥

Image URL Error

图像URL错误

Error: Could not fetch image from URL

Make sure:
1. The image URL is publicly accessible
2. The URL points directly to an image file
3. The image format is supported (JPEG, PNG, WebP)

错误：无法从指定URL获取图像

请确认：
1. 图像URL可公开访问
2. URL直接指向图像文件
3. 图像格式受支持（JPEG、PNG、WebP）

Network Error

网络错误

Network error. To fix on claude.ai:

1. Go to https://claude.ai/settings/capabilities
2. Add *.fal.ai to the allowed domains
3. Try again

网络错误。在claude.ai上的修复方法：

1. 访问https://claude.ai/settings/capabilities
2. 将*.fal.ai添加到允许的域名列表
3. 重试