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 也算作传参。无论哪种情况,这两个参数都仍然出现在工具 schema
中,因为 schema 在服务器启动时发布,无法按请求变化。见
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 枚举在运行时列出它们:
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
提示¶
小技巧
工作流思路:用 lineart 从照片提取线稿,再把它作为 ControlNet 条件
(见 annotate_image)做一次全新的风格化生成。
defry 的语义
defry 是 NovelAI 的 “de-fry” 参数 —— 它减轻激进线稿提取可能产生的过度平滑、
“湿” 的观感。值越大线条越锐利,但会引入抖动。5 是不错的折中。
另请参见¶
DirectorTool枚举 —— 列于nai.constants子模块ControlNet 教程 —— 把
lineart与annotate_image组合使用