チュートリアル: 画像から画像¶
image_to_image ツールで、新しいプロンプトを使って既存の画像を変換します。細部の
調整、スタイルの変更、ゼロからの作り直しなしでの構図の反復に最適です。
1. 入力画像を読み込む¶
image_to_image は入力を base64 でエンコードされた PNG/JPEG 文字列として期待します。
Python でスクリプトを書く場合は次のようにします:
import base64
from pathlib import Path
image_b64 = base64.b64encode(Path("input.png").read_bytes()).decode("ascii")
CLI はファイルパスを直接受け取るため、手動での base64 変換は不要です。
2. image-to-image を実行する¶
result = await ctx.session.call_tool("image_to_image", {
"prompt": "1girl, masterpiece, smiling, golden hour lighting",
"image": image_b64,
"strength": 0.4,
"noise": 0.05,
"seed": 42,
})
3. strength を調整する¶
strength (0.01–0.99) が最も重要なパラメーターです:
|
効果 |
|---|---|
0.1–0.3 |
微妙な調整 — 細部を修正し、構図を保ちます。 |
0.4–0.6 |
バランス型 — スタイル / ライティングの変化が目に見え、アイデンティティは保たれます。 |
0.7–0.9 |
大幅 — 新規の text-to-image に近づき、入力はほとんど見えなくなります。 |
Tip
0.5 から始めます。結果が入力に似すぎている場合は 0.6 に上げ、入力の
アイデンティティが失われている場合は 0.4 に下げてください。
4. 制御されたノイズを加える¶
noise (0–0.99) は入力画像の 上に 追加のランダム性を注入します。strength を
変えずにばらつきを加えたいときに使います:
result = await ctx.session.call_tool("image_to_image", {
"prompt": "1girl, masterpiece",
"image": image_b64,
"strength": 0.5,
"noise": 0.2, # 20% noise
"extra_noise_seed": 99, # separate seed for the noise (defaults to `seed`)
})
5. Python API を使う¶
MCP ホストなしでスクリプトを書く場合は、基盤となるクライアントを直接呼び出します:
注釈
直接 API を使う例では create_http_client() を使います — httpx.AsyncClient() を
手書きで しないでください。NovelAI の Cloudflare WAF は TLS スタック (JA3/JA4) を
指紋照合し、ブラウザ以外の接続を無言でリセットします。create_http_client() は
Chrome を偽装するもので、image.novelai.net でサポートされる唯一のトランスポートです。
import asyncio
import base64
from pathlib import Path
from novelai_image_mcp.nai import (
Action, GenerationRequest, Model, create_novelai_client,
)
from novelai_image_mcp.nai.http import create_http_client
from novelai_image_mcp.settings import NovelAISettings
async def main():
settings = NovelAISettings(token="pst-...")
image_b64 = base64.b64encode(Path("input.png").read_bytes()).decode("ascii")
async with create_http_client(timeout=settings.timeout) as http_client:
client = create_novelai_client(settings, http_client=http_client)
try:
request = GenerationRequest(
prompt="1girl, masterpiece, smiling",
action=Action.IMG2IMG,
model=Model.V4_5,
image=image_b64,
strength=0.4, noise=0.05, seed=42,
)
images = await client.generate(request)
finally:
await client.aclose()
asyncio.run(main())
次のステップ¶
Inpainting — 特定の領域を再描画する
アップスケール — 解像度を上げる