mcpField
F
fal-upscale

fal-upscale

github.com/fal-ai-community创意与媒体258273 次安装24 周前更新
代码仓库

关于 fal-upscale

通过 fal.ai 超分模型提高图像分辨率的技能。输入图像 URL 和可选缩放倍数，并可搜索图像或视频增强模型。

主要功能

  1. 01通过 URL 放大图像
  2. 02选择模型和缩放倍数
  3. 03发现图像与视频模型
  4. 04返回放大后的图像 URL 和尺寸

适用场景

  1. 01提高指定图像的分辨率
  2. 02查找合适的图像超分模型
  3. 03查找视频放大模型

MCP 相关

可使用 search_models MCP 工具查找超分模型，再通过发现的 modelId 调用 mcp__fal-ai__generate。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/fal-ai-community/skills --skill fal-upscale

安装后在 Claude Code 中输入/fal-upscale确认已加载。

附带文件scripts/upscale.sh

详细介绍

fal.ai Upscale

使用先进的 AI 模型提升并增强图像分辨率。

工作原理

  1. 用户提供图像 URL 和可选的缩放倍数
  2. 脚本选择合适的放大模型
  3. 向 fal.ai API 发送请求
  4. 返回放大后的图像 URL

查找模型

要发现最佳和最新的图像放大模型，请使用搜索 API：

# Search for image upscale models
bash /mnt/skills/user/fal-generate/scripts/search-models.sh --query "upscale image"

# Search for video upscale models
bash /mnt/skills/user/fal-generate/scripts/search-models.sh --query "upscale video"

# Search for super-resolution models
bash /mnt/skills/user/fal-generate/scripts/search-models.sh --query "super resolution"

或者使用 search_models MCP 工具，并输入“upscale”“super resolution”“enhance”等关键词。

用法

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

参数：

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

示例：

# Image upscale with AuraSR (4x, fast)
bash /mnt/skills/user/fal-upscale/scripts/upscale.sh \
  --image-url "https://example.com/image.jpg"

# Image upscale with Clarity (detail preservation)
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"

MCP 工具替代方案

使用 search_models MCP 工具或 search-models.sh 查找当前最佳的图像放大模型，然后调用 mcp__fal-ai__generate，并传入发现的 modelId。

输出

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

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

JSON 输出：

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

向用户展示结果

Here's your upscaled image:

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

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

模型选择技巧

  • 图像放大：搜索“upscale image”或“super resolution”。权衡速度与质量。
  • 视频放大：搜索“upscale video”。高级模型的质量更好，但成本也更高。
  • 缩放倍数通常为 2x 到 4x，具体取决于模型。

故障排除

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
图像 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)
网络错误
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

评论

支持 Markdown