mcpField
F
fal-upscale

fal-upscale

github.com/fal-ai-communityクリエイティブ・メディア258273 回インストール24 週間前に更新
リポジトリ

fal-upscale について

fal.aiのアップスケーリングモデルで画像の解像度を高めるスキルです。画像URLと任意の倍率を受け取り、画像や動画の補正モデルも検索できます。

主な機能

  1. 01URLから画像をアップスケール
  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 アップスケール

最先端の 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"

または、「upscale」、「super resolution」、「enhance」などのキーワードを使って search_models MCP ツールを使用します。

使用方法

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 を使用して現在最適なアップスケールモデルを見つけ、その後、見つかった modelId を指定して mcp__fal-ai__generate を呼び出します。

出力

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 対応