mcpField
I
image-upscale

image-upscale

github.com/agntswrm创意与媒体646 次安装34 周前更新
代码仓库

关于 image-upscale

image-upscale 是一项通过 AI 超分辨率模型放大图像的命令行技能，支持文件路径或 URL 输入，并提供本地及托管服务商选项。

主要功能

  1. 01支持 2x 或 4x 放大
  2. 02使用 Transformers.js 在本地 CPU 处理
  3. 03支持 fal 和 Replicate 服务商
  4. 04可指定模型和输出路径

适用场景

  1. 01放大本地文件中的图像
  2. 02放大通过 URL 提供的图像
  3. 03为放大任务选择服务商

安装

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

$npx skills add https://github.com/agntswrm/agent-media --skill image-upscale

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

详细介绍

图像超分辨率

使用 AI 超分辨率模型放大图像，在提高分辨率的同时生成逼真的细节。

命令

npx agent-media@latest image upscale --in <path> [options]

输入

选项必需说明
--in是输入文件路径或 URL
--scale否缩放倍数（2 或 4，默认值：2）
--out否输出路径、文件名或目录（默认值：./）
--provider否要使用的提供方（local、fal、replicate）
--model否要使用的模型（覆盖提供方默认模型）

输出

返回包含超分辨率图像路径的 JSON 对象：

{
  "ok": true,
  "media_type": "image",
  "action": "upscale",
  "provider": "local",
  "output_path": "upscaled_123_abc.png",
  "mime": "image/png",
  "bytes": 456789
}

示例

将图像放大（默认 2 倍）：

npx agent-media@latest image upscale --in photo.jpg

使用指定提供方放大 4 倍：

npx agent-media@latest image upscale --in photo.jpg --scale 4 --provider fal

使用自定义输出路径进行放大：

npx agent-media@latest image upscale --in photo.jpg --out ./upscaled

提供方

local

使用 Transformers.js 在 CPU 上本地运行，无需 API 密钥。

  • 使用 Xenova/swin2SR-compressed-sr-x4-48 模型（约 1.3MB）
  • 无论 --scale 的值如何，始终输出 4 倍放大图像（模型架构限制）
  • 首次使用时会下载模型
  • 你可能会看到 mutex lock failed 错误；可忽略。如果 "ok": true，则输出正确
npx agent-media@latest image upscale --in photo.jpg --provider local
fal
  • 需要 FAL_API_KEY
  • 使用 fal-ai/esrgan（Real-ESRGAN）模型
  • 支持 2 倍和 4 倍缩放
replicate
  • 需要 REPLICATE_API_TOKEN
  • 使用 nightmareai/real-esrgan 模型
  • 支持 2 到 10 倍缩放

评论

支持 Markdown