transform-upscale-image-with-transloadit

実行

ローカル画像をすばやく AI でアップスケールするには、image upscale インテントを使用します。

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 を試してください。