用途:使用 AI 超分辨率模型放大图像,提升分辨率并生成细节,适合放大图片、改善低分辨率照片。
用法:通过 agent-media 命令行调用。 命令:npx agent-media@latest image upscale --in <path> [options]
主要参数: --in:必填,输入文件路径或 URL。 --scale:可选,放大倍数(2 或 4,默认 2)。 --out:可选,输出路径、文件名或目录(默认 ./)。 --provider:可选,使用的 provider(local、fal、replicate)。 --model:可选,指定模型,覆盖 provider 默认值。
输出:返回 JSON 对象,包含放大后图片路径,字段包括 ok、media_type、action、provider、output_path、mime、bytes。
示例: 默认 2x:npx agent-media@latest image upscale --in photo.jpg 4x 并指定 provider:npx agent-media@latest image upscale --in photo.jpg --scale 4 --provider fal 自定义输出:npx agent-media@latest image upscale --in photo.jpg --out ./upscaled
Provider 说明: local:本地 CPU 运行,基于 Transformers.js,无需 API key;使用 Xenova/swin2SR-compressed-sr-x4-48 模型(约 1.3MB);受模型架构限制,始终输出 4x,忽略 --scale;模型首次使用时下载;可能出现 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)模型;支持 2x 和 4x。 replicate:需要 REPLICATE_API_TOKEN;使用 nightmareai/real-esrgan 模型;支持 2 到 10x。
限制:不同 provider 的放大倍数、模型与密钥要求不同;local 固定 4x。收费、价格、平台等未在资料中提供。