transform-upscale-image-with-transloadit

运行

使用 image upscale 意图快速 AI 放大本地图片。

npx -y @transloadit/node image upscale \
  --input ./photo.jpg \
  --output ./photo-upscaled.png

默认值：--model nightmareai/real-esrgan、--scale 2、--face-enhance false。

以 4 倍比例运行

npx -y @transloadit/node image upscale \
  --input ./photo.jpg \
  --scale 4 \
  --output ./photo-upscaled.png

运行并增强人脸

当输入图片包含需要锐化的人脸时使用。搭配 gfpgan 或 codeformer 进行专门的人脸修复；也可以使用 real-esrgan + --face-enhance，在通用放大的同时改善人脸效果。

--face-enhance 是一个布尔标志——直接传入即可，不要加上 true。

npx -y @transloadit/node image upscale \
  --input ./portrait.jpg \
  --face-enhance \
  --output ./portrait-upscaled.png

选择模型

• nightmareai/real-esrgan（默认）：适用于照片和插画的通用 SOTA 放大模型。
• tencentarc/gfpgan：专用于人脸修复；最适合修复人脸受损或质量较差的人像。
• sczhou/codeformer：另一种人脸修复方案，可更灵活地控制保真度与画质。

npx -y @transloadit/node image upscale \
  --input ./portrait.jpg \
  --model tencentarc/gfpgan \
  --output ./portrait-restored.png

注意：

• 放大属于 AI 操作；处理时间和成本会随图片尺寸及 --scale 增加。
• 如果未指定 --output，CLI 会使用该意图的默认扩展名，将输出写入输入文件所在目录。
• --scale 仅接受 2 或 4。

失败时的调试方法

npx -y @transloadit/node assemblies get <assemblyIdOrUrl> -j

注意：

• 放大机器人可能受账户权限限制；如果组装因能力或可用性错误而失败，请确认你的账户已启用 /image/upscale，或切换 --model。
• 超大输入结合 --scale 4 可能超出单账户限制；请先尝试 --scale 2。