upscale_image¶
NovelAI のスタンドアロンアップスケーラーで画像を 4 倍にアップスケールします。
アップスケーラーは入力画像を生成したモデルに関係なく、NOVELAI_UPSCALE_MODEL で
設定された V5 モデルで動作します。
パラメーター¶
名前 |
型 |
デフォルト |
備考 |
|---|---|---|---|
|
|
必須 |
アップスケールする base64 エンコードの PNG/JPEG。 |
|
|
|
|
戻り値¶
list[ContentBlock] — アップスケール後の画像の base64 Image と、保存先パスのテキスト。
動作¶
アップスケーラーは別個の NovelAI エンドポイントです — 拡散ループを実行 しない ため、 より高解像度で再生成するよりも高速です。
Anlas コストは元の解像度に比例します (倍率は 4 倍で固定)。大きなバッチの 前に
estimate_anlas_costを使ってください。出力は入力のカラープロファイルとアスペクト比を保ちます。アップスケール中に アスペクト比を変更することはできません。
例¶
await ctx.session.call_tool("upscale_image", {
"image": image_b64,
"factor": 4,
})
CLI¶
uv run python -m novelai_image_mcp upscale ./portrait.png --factor 4
ヒント¶
Tip
アップスケールと再生成のどちらを選ぶか?
ほぼ完璧な画像がすでにあり、より高い解像度だけが必要な場合はアップスケールします。
構図、ライティング、細部を変えたい場合は再生成します。元の 2 倍の解像度で 再生成すると、アップスケールよりきれいな結果が得られることが多いですが、 Anlas の消費は増えます。
メモリ使用量
1024×1024 の画像を 4 倍にアップスケールすると 4096×4096 の出力
(非圧縮 PNG で約 64 MB) になります。NOVELAI_OUTPUT_DIR のボリュームに
空きがあることを確認してください。
関連項目¶
アカウント残高 — バッチの前に Anlas を確認する