チュートリアル: アップスケール

NovelAI のスタンドアロンアップスケーラーを使って画像の解像度を 4 倍にします。 アップスケーラーは、より高い解像度で再生成するよりも高速で、きれいな結果を 生み出します。

1. 画像をアップスケールする

import base64
from pathlib import Path

image_b64 = base64.b64encode(Path("portrait.png").read_bytes()).decode("ascii")

result = await ctx.session.call_tool("upscale_image", {
    "image": image_b64,
    "factor": 4,
})

出力 PNG は元の解像度の 4 倍になります。832×1216 の入力は 3328×4864 になります。

2. factor は 4 で固定

NovelAI のスタンドアロンアップスケーラーは 4 倍の 1 段階のみを公開しているため、 factor は 4 だけを受け付けます — 2 倍モードはありません。より小さい倍率を 探すのではなく、低い解像度で生成して 1 回アップスケールしてください。

Anlas コストは元の解像度に比例します。バッチでアップスケールする場合は、先に estimate_anlas_cost を使ってください。

3. CLI での同等の実行

uv run python -m novelai_image_mcp upscale ./portrait.png --factor 4

4. ワークフロー: 生成 → アップスケール

よくあるパターンは、高速な反復のために低い解像度で生成し、採用する 1 枚を アップスケールするというものです:

# Step 1: iterate at 832×1216 (cheap, ~5 Anlas each)
result = await ctx.session.call_tool("generate_image", {
    "prompt": "1girl, masterpiece",
    "width": 832, "height": 1216,
    "n_samples": 4,
})
# (you pick the best of the 4 — say, outputs/generate-...003.png)

# Step 2: upscale the keeper to 3328×4864
import base64
from pathlib import Path
keeper_b64 = base64.b64encode(
    Path("outputs/generate-...003.png").read_bytes()
).decode("ascii")

result = await ctx.session.call_tool("upscale_image", {
    "image": keeper_b64,
    "factor": 4,
})

これにかかるコストはバッチで約 5 Anlas + アップスケールで約 10 Anlas = 合計約 15 Anlas です — 4 倍の画像を 4 枚直接生成する (約 80 Anlas) よりもはるかに安価です。

5. 落とし穴

警告

メモリ使用量。 1024×1024 の画像を 4 倍にアップスケールすると 4096×4096 の PNG (非圧縮で約 64 MB) になります。ディスク容量をそれに合わせて計画してください。

Tip

Inpaint の前にアップスケール。 細部を修正する必要がある場合、先にアップスケール すると inpaint モデルが扱えるピクセルが増え、より細かいマスクと良好なディテールが 得られます。

次のステップ