director_tool¶
NovelAI の Director ツール を画像に適用します。Director ツールは既存の画像を 派生的な形 — ラインアート、スケッチ、背景除去、declutter、カラー化、感情転送 — に 変換します。
パラメーター¶
名前 |
型 |
デフォルト |
備考 |
|---|---|---|---|
|
|
必須 |
|
|
|
必須 |
base64 でエンコードされた PNG/JPEG。 |
|
|
|
|
|
|
|
0–10。ラインアートを強調します ( |
|
|
|
感情名 ( |
|
|
|
0–5。0 = 通常の強度、5 = 最も弱い。 |
警告
emotion と emotion_level は 実験的 です: insiders ヘッダー
(X-MCP-Insiders: experimental-tools=true) で opt-in したリクエストにのみ提供されます。
opt-in がない状態でどちらかを渡すと ToolError で失敗します。デフォルト以外の
emotion_level だけでも「渡した」とみなされます。どちらのパラメーターもツール
スキーマには表示されたままです — スキーマはサーバー起動時に公開されるため、
リクエストごとに変化させられないからです。
Insiders ヘッダー、ルーティング、監査 を参照してください。
戻り値¶
list[ContentBlock] — 変換後の画像の base64 Image と、保存先パスのテキスト。
Director ツール¶
|
説明 |
|---|---|
|
画像をクリーンなラインアートに変換します。 |
|
鉛筆スケッチ風に変換します。 |
|
背景を除去し、前景の被写体を透明の上に残します。 |
|
小さな不要物 (文字、ウォーターマーク、粒子) を除去します。 |
|
モノクロ / ラインアートの画像に着色します。 |
|
被写体に顔の感情を転送します。 |
感情名¶
emotion パラメーターは以下の値を受け付けます:
neutral, happy, sad, angry, scared, surprised, tired, excited, nervous,
thinking, confused, shy, disgusted, smug, bored, laughing, irritated,
aroused, embarrassed, worried, love, determined, hurt, playful
Emotion enum をイントロスペクトして実行時に一覧表示できます:
from novelai_image_mcp.nai import Emotion
print([e.value for e in Emotion])
例¶
ラインアートの抽出¶
await ctx.session.call_tool("director_tool", {
"tool": "lineart",
"image": image_b64,
"defry": 5,
})
背景の除去¶
await ctx.session.call_tool("director_tool", {
"tool": "bg-removal",
"image": image_b64,
})
スケッチの着色¶
await ctx.session.call_tool("director_tool", {
"tool": "colorize",
"image": sketch_b64,
"prompt": "1girl, red hair, blue dress, sunny day",
})
感情の転送¶
await ctx.session.call_tool("director_tool", {
"tool": "emotion",
"image": portrait_b64,
"emotion": "happy",
"emotion_level": 2,
})
CLI¶
# Line art extraction
uv run python -m novelai_image_mcp director lineart ./portrait.png --defry 5
# Colorize a sketch
uv run python -m novelai_image_mcp director colorize ./sketch.png --prompt "1girl, red hair"
# Emotion transfer
uv run python -m novelai_image_mcp director emotion ./portrait.png --emotion happy --emotion-level 2
ヒント¶
Tip
ワークフローの例: lineart で写真からラインアートを抽出し、それを ControlNet の
条件として使う (annotate_image を参照) ことで、新たに様式化した
生成を行えます。
defry の意味
defry は NovelAI の「de-fry」パラメーターです — 強引なラインアート抽出が生む、
平滑化されすぎた「濡れた」見た目を軽減します。値が大きいほど線は強調されますが
ジャギーが増えます。5 が良い中間点です。
関連項目¶
DirectorToolenum —nai.constantsサブモジュールに記載ControlNet チュートリアル —
lineartとannotate_imageを組み合わせる