快速入门

安装插件

安装包可在下载与安装页面下载，提供一键安装包与 zip 包两种形式。通过淘宝店铺购买订阅时，自动发货信息中也附有安装包下载链接，该链接始终指向当前版本的一键安装包。安装步骤详见下载与安装。安装完成后重启 Nuke，左侧节点工具栏中出现 pixRepaint 菜单即表示安装成功。

开始之前

使用插件前，需准备以下各项：

• RunningHub 账号。模型运算在该平台完成。
• pixRepaint 订阅码。个人版、小团队版与企业版订阅码均通过淘宝店铺购买，月付，每张订阅码兑换后 31 天有效，付款后自动发送订阅码与安装包下载链接，价格详见价格方案。免费试用无需购买订阅码：首次激活时订阅码填写通用试用码 8888（默认已预填）即可，试用期 10 天，自首次激活之日起计算，每个 RunningHub ID 仅可试用一次，详见免费试用。
• RunningHub ID 与 API Key。RunningHub ID 在 RunningHub 个人中心查看，为昵称旁「ID:」后面的一串数字；API Key 在 RunningHub API Key 页面复制，消费级-会员或企业级-共享 API Key 均可。两个页面均需先登录 RunningHub，填写方法详见下一节。

运算费用支付给 RunningHub，订阅费用支付给我们，两者分别结算。如何准备 RH 币或钱包余额、获取并添加 API Key，详见配置算力。

激活插件

首次使用时，请打开 Nodes › pixRepaint › 账号与许可证 › 首次激活…，创建插件账号并兑换订阅码（图文步骤见上手指南）。「首次激活…」窗口的各项内容如下表。

填写完成后点击「激活」，插件将创建账号、兑换订阅码并登录本机，随后打开「账号管理…」窗口。未登录时，「首次激活…」与「登录…」可用、「账号管理…」为灰色；登录后则相反。如需切换账号，请先在「账号管理…」中点击「退出登录」。

每个账号只需激活一次。同一账号在其他机器上使用时，请选择「登录…」，无需再次激活。

登录与找回密码

在新机器上使用，或退出登录后再次使用时，请打开 Nodes › pixRepaint › 账号与许可证 › 登录…，填写账号名和密码（本机标签与机器档位可一并修改），点击「登录」。登录时无需再次填写订阅码与 RunningHub ID。API Key 仅保存在各台机器本地，在新机器上登录后，请在「账号管理…」中点击「添加 Key」。

账号名或密码有误时显示「账号名或密码错误」。当日输错次数过多时将暂停登录，次日恢复。

忘记密码时，请在登录窗口点击「忘记密码…」，填写账号名、「最近一次兑换的付费订阅码」、「新密码」与「再输一次」，点击「重置」。

• 仅使用过试用码的账号无法自助重置，请通过邮箱 pixRepaint@163.com 联系我们。
• 重置成功后，该账号下所有机器均退出登录，需使用新密码重新登录。

登录时如在线机器数已达当前档位的上限，插件将提示「在线机器数已达上限。请下线一台机器，或等待其闲置一小时后自动释放」，并列出该账号下的机器。选择一台机器将其下线后，即可继续登录，无需再次输入密码。

账号管理

登录后，请打开 Nodes › pixRepaint › 账号与许可证 › 账号管理…。窗口中显示账号名、RunningHub ID（部分隐藏）及其绑定状态、当前使用的 API Key、「服务」状态、档位、各档位的到期时间、已登录机器数与上限、正在运行的任务数与上限、「平台 Key」（API Key 在 RunningHub 的类型及平台并发上限）、可用额度或 RH 币余额、机器档位与插件版本。窗口中的按钮与选项如下。

API Key

API Key 可在 RunningHub API Key 页面复制（消费级-会员或企业级-共享均可）。API Key 仅保存在本机，只用于向 RunningHub 提交任务，我们的服务器不接收也不保存。每个账号可在本机保存多个 API Key，在下拉框中切换后点击「保存设置」生效。API Key 须属于账号绑定的 RunningHub ID；如使用了其他 ID 下的 API Key，「账号管理…」窗口将显示提醒，后续任务可能无法运行，请改用绑定 ID 下的 API Key。

续费与升档

续费或升档时，请先在淘宝店铺购买订阅码，再点击「续费 / 升档」并填写新的订阅码。兑换同一档位的订阅码时，新增时长接在现有剩余时间之后；兑换更高档位的订阅码时，新档位立即生效，原档位的剩余时间顺延至新档位到期之后。「到期」一栏会列出各档位的到期时间。订阅到期后仍可登录，并在「账号管理…」中续费。

RunningHub ID 绑定

每个插件账号绑定一个 RunningHub ID。账号首次在 RunningHub 上成功运行任务之前，绑定状态显示「尚未在平台成功运行，可修改绑定」，可通过「改绑 ID」修改；成功运行之后显示「已确认」，绑定锁定，「改绑 ID」按钮不再显示，如需修改请联系我们。改绑不会重新获得试用。

同一个 RunningHub ID 可以被多个插件账号绑定，此时窗口中会显示「该 RunningHub ID 同时绑定了其他插件账号，各账号的机器数和并发数分别计算」。各账号的机器数、并发数与到期时间分别计算，不合并。

机器管理与档位规格

同一账号可在多台机器上登录。可同时在线的机器数与可同时运行的任务数由订阅档位决定：

付费档位均为月付，每张订阅码兑换后 31 天有效，价格详见价格方案。实际可同时运行的任务数还受您的 RunningHub 会员档位与 API Key 类型限制，可在「账号管理…」的「平台 Key」一栏查看；各档位建议开通的会员见选哪一档 RunningHub 会员。任务数达到上限时，新提交的任务将在本地排队，前面的任务完成后自动提交。

• 更换机器：在新机器上通过「登录…」登录同一账号即可。如在线机器数已达上限，登录时可选择一台机器下线后继续。
• 停用旧机器：在旧机器上点击「退出登录」，或在其他机器的「账号管理…」中点击「下线其他机器」。
• 自动释放：机器连续 1 小时无活动后，自动释放其在线名额。

服务状态指示灯

「账号管理…」窗口与各节点面板上均设有「服务」状态指示，含义如下。

• 绿色：可以正常提交任务。
• 黄色：暂时无法连接授权服务，正在使用本机保存的授权继续提交任务。
• 红色：当前无法提交任务，旁边显示的文字即为具体原因，请据此处理。

首次重绘

请新建一个 Rp M Paint 节点，并完成以下连接：

• source：接入源素材。
• mask：接入遮罩（「遮罩取自」可选 alpha 或 luma），白色区域为需要重绘的范围；未接入遮罩时将对整帧进行重绘。
• refs：可选，接入参考素材，详见下一节。
• control：可选，接入结构控制视频，详见本节「结构控制」。

强度在「模式」中选择：统一强度以单一 denoise 数值控制整块遮罩区域，可在「档位」中选择「轻（加质感）」「中（翻新材质）」「重（重画）」「完全（全重画）」，也可直接调整 denoise 与 steps；分级强度通过遮罩灰度控制各区域的重绘强度（白色对应 inside、黑色对应 outside），可在同一遮罩内实现不同区域的强弱差异。

「传输质量」设有两档：快速（默认）上传 H.264 10-bit，文件体积更小，由插件内置的 ffmpeg 完成转码；高质量上传 ProRes 4444 12-bit，颜色最准、文件更大。云端生成的结果同样按所选档位回传，下载后自动转为 ProRes 4444。

帧范围下一行的开头帧数参数可设为 0～16，默认 0（不启用），用于改善生成结果开头几帧颜色不稳定的问题，一般设为 5～8，生成结果的帧数不变。启用后计算帧数可能增加一档，提交时状态栏会注明按多少帧计算。

「锚点 / 参考强度」控制参考图与锚点的约束程度，默认 0.999，调低后约束放松；参考图与锚点共用该数值，未接入 refs 时不起作用。该参数为实验功能。

底模版本在「高级（一般不用动）」分组的「模型」中选择：列表第一项为新版（默认），第二项为老版。高级分组需在「选项…」中勾选「显示高级参数」后显示。

结构控制

control 口接入结构控制视频，用于约束生成结果的空间结构，可使用 Rp Control 生成的深度图或线稿，也可使用 Roto 绘制的白线轮廓。控制视频以黑底白线（线稿、轮廓）最为稳定，深度图需近白远黑。相关参数如下：

• 「控制强度」：默认 1，低于 1 时约束变松，0 表示不使用控制。
• 「控制起」「控制止」：控制作用的去噪进程区间，默认 0～1。例如设为 0～0.5 时，前半段确定大的形状和位置，后半段由模型自由补充细节。
• 「使用遮罩」：默认关闭。开启后遮罩与源素材也交给结构控制；遮罩内控制图为空白或实心色块的区域容易出现发暗的方块，仅当控制图在遮罩内均为清晰的白线轮廓时建议开启。

提交与进度

提交前请先保存工程：上传前渲染的素材缓存与生成结果均存放在工程所在目录旁的 pixRepaint 文件夹中。点击「提交」后，可在面板上查看上传进度与速度、排队和生成进度，任务完成后将在旁边自动创建结果节点。roto 请按工程尺寸绘制，插件会自动等比缩放至生成所需的尺寸。

Rp M Paint、Rp M Paint Pass2 Upscale、Rp M Sharpen、Rp M Motion Fix、Rp M Remove 提交前会估算本次任务的规模，超出模型一次能处理的上限时弹窗提示：继续提交时结果容易出现乱块，也可能运行很慢甚至卡住。提示中会给出缩短帧范围、缩小画布或减少参考素材等建议，可选择继续提交或取消。

参考素材和提示词

参考素材统一接入 Rp M Refs，共三个端口。每个端口只有一项素材时可直接接入，有多项素材时请用 AppendClip 串联后接入：

• refpic：参考图，最多 9 张。
• anchors：锚点图，最多 8 个。默认放置在素材自身所在的帧，也可在「锚点帧号」中指定位置；锚点提供强引导而非直接贴合，建议间隔 40 帧以上。
• refvid：参考视频，最多 3 段，按 24fps 计算，超过 15 秒的部分将被截断。

提示词中使用以下标签引用素材，编号按接入 AppendClip 的顺序排列，三类分别从 1 开始计数：

例如可先写一句：「<Subject 1> 的外观来自 <Picture 1>，运动来自 <Video 1>」。提示词输入框内置起始模板，【】中为需替换的内容。RunningHub 后端不支持参考音频，提示词中无需填写。

二阶放大

Rp M Paint Pass2 Upscale 接入上一步的结果节点后，将自动沿用提示词、参考素材、锚点与底模版本，无需重新填写。如需调整，可通过「改提示词」「改参考素材」两个开关分别覆盖。

该节点自身的参数包括：「尺寸模式」与「放大倍数」、「精修步数」、「重画起点」。「遮罩」提供三种模式：「不用」（整帧重画）、「用上一步的」（沿用上一步送出的遮罩）、「接新的」（mask 端口接入新的 roto）。

裁切重绘

裁切重绘仅将 roto 周边区域送出运算，适用于区域占画面比例较小的情况，可显著提升清晰度。裁切框提供两种方式：

• A 合并框：整条镜头使用同一个静态框。
• B 跟随框：框逐帧跟随 roto 移动。

回贴步骤需手动生成，请在结果节点上点击「创建回贴节点」，原片、当时使用的 roto 与结果将自动接入。回贴节点的「谁不变」提供「原片不变（结果缩回框）」「结果不变（原片放大到结果）」两种模式。如需将源素材上的其他内容（例如另一层 roto）按同一个框裁切，请点击「创建裁切节点」。

结果节点

任务完成后将自动创建一个带输入端口的 Read 节点，label 中标注该任务的耗时。输入端口仅用于标记该结果由哪个节点生成，不参与计算。面板上提供以下按钮：

• 「恢复生成节点（当时参数）」：按提交时的参数重建生成该结果的节点，输入连线按当时的节点名接回。
• 「创建裁切节点」「创建回贴节点」：仅对裁切模式生成的结果可用，详见上一节。

拖影修复

Rp M Motion Fix 修复快速运动或镜头甩动造成的拖影与运动模糊：只重新生成模糊的几帧，其余帧保持原片。输入端口如下：

• source：需要修复的视频。
• mask：可选，接入 roto，白色为修复段中需要重新生成的区域，黑色保持原样（例如需要保留的人物）；未接入时修复段整帧重新生成。
• refs：可选，接入 Rp M Refs 或一段素材作为参考图。

first / last 为送去处理的帧范围，修复段以外的帧仅作为上下文，回贴时使用原片；范围越长处理越慢。常用参数：

• 「修复段」：选择「自动找」时，提交时自动查找画面模糊且运动较快的连续帧，可先点击「分析画面」查看结果；选择「手动填」时在右侧填写 Nuke 帧号，例如 1004-1010, 1020，可填写多段。
• 「分析画面」下一行的处理档位：「4 次（快）」较快；「8 次（清楚，约慢 2.7 倍）」画面更清晰，耗时约为 2.7 倍。
• 「重画幅度」：默认 0.7，范围 0.3～1，数值越大改动越多。
• 裁切：与裁切重绘相同，适用于画面中只有局部快速运动的镜头，需接入 mask。

完成后生成结果节点。点击结果节点上的「创建回贴节点」，修复段使用生成结果、其余帧使用原片（裁切时先按 roto 将结果贴回原片）。该节点只处理时间方向上的模糊，画面整体偏软时可再用其他节点处理。

擦除

Rp M Remove（实验性）擦除 roto 范围内的人物或物体并补出背景。长镜头自动分段生成。处理耗时约为同分辨率、同长度 Rp M Paint 的 2.5 倍，建议使用较低的分辨率，新建节点的放大倍数默认为 0.75。输入端口如下：

• source：需要擦除的视频。
• mask：必须接入 roto，白色为需要擦除的区域。
• refs：可选。可接入一张擦干净的首帧（帧范围第一帧擦除后的画面，取景与尺寸须与 source 一致），可明显减少擦除区域内补出多余内容的情况；首帧请擦除彻底，残留的淡轮廓或脏点可能被保留并逐渐放大。人物从画外走入等干净画面不在第一帧的镜头，可接入 Rp M Refs：参考图最多 8 张，锚点仅接受单帧。

常用参数：

• 「每段帧数」：22 / 39（默认）/ 56 / 73。
• 「接缝」：「重叠淡入」（默认）在相邻两段重叠的帧上逐渐过渡；「直接接」稍快，接缝处可能跳动。
• 「冒东西自动重抽」：默认开启。擦除区域内补出多余内容时，自动重新生成该段（最多 2 次）；每次重抽多消耗一次生成的算力。关闭后只在状态中提醒。
• 「逐帧调色」：默认开启，逐帧校正生成结果的亮度与颜色，使其与原片衔接。
• 裁切：与裁切重绘相同，默认 A 合并框；人物占画面大部分时请选择「无」。

完成后生成结果节点，为完整的一段画面（生成画布尺寸）。裁切时点击结果节点上的「创建回贴节点」，只将 roto 区域贴回原片；不裁切时请自行合成。任一段失败需重新提交整条；关闭 Nuke 后，该节点未完成的任务不会自动接回。

色彩匹配

Rp ColorMatch 在云端将一段素材的颜色与影调匹配到参考素材，支持整帧匹配与按 roto 限定采样区域的匹配。输入端口如下：

• target：需要校色的视频。
• ref：参考视频。
• roto：可选，白色为参与采样的区域（例如人物）。接入后使用遮罩匹配，算出的调色统一套用到整帧。
• ref_roto：可选，ref 中的主体与 target 位置不一致时，单独圈定 ref 的采样区域。

未接入 roto 时，在「method」中选择整帧匹配算法，建议先使用 mkl；接入 roto 时，在「roto method」中选择，target 与 ref 为同一镜头、画面位置对应时（例如生成结果对原片）使用默认的 paired，位置不对应时可改用 mkl。其他常用选项：

• 「预览遮罩」：提交前在节点输出画面上叠加半透明红色，检查采样区域是否正确，不影响送出匹配的素材。接入 ref_roto 时，可通过「看」切换查看 target 或 ref 一侧。
• 「采样间隔」：遮罩匹配时可用，统计颜色时每隔几帧取一帧，默认 1（逐帧）。仅影响 ref 与 roto 的采样，target 仍逐帧调色；长镜头设为 4～8 可显著缩短处理时间。开启「逐帧稳定亮度 / 颜色」时只能为 1。
• 「逐帧稳定亮度 / 颜色」：默认关闭，遮罩匹配时可用，用于消除素材自身逐帧的亮度与颜色闪烁。roto 请圈选内容稳定的区域。

色彩匹配对颜色精度较为敏感，「传输质量」建议使用高质量。

结构控制

Rp Control 从原片或 3D 渲染生成结构参考视频，输出接入 Rp M Paint 的 control 口（详见首次重绘中的「结构控制」），深度图也可直接用于合成。「类型」提供以下四种：

• 「深度」：灰度深度图，近白远黑，约束空间前后关系与大的形体。
• 「Canny」：细边缘线，细节较多，纹理也会被提取。
• 「HED」：软边缘线，只保留大的轮廓，一般最适合作为线稿控制图。
• 「MLSD」：只保留直线段，适用于建筑与室内场景。

旧工程中的 Rp Depth 节点仍可正常打开。

画质修复与慢动作

Rp Enhance 调用您本人的 Topaz Video AI 完成画质修复、放大与慢动作补帧。Topaz Video AI 为第三方桌面软件，需由您自行购买、安装并登录；pixRepaint 不提供、不销售也不管理该软件。Topaz 可安装在本机，也可安装在局域网内的另一台电脑上。

• 「输出尺寸」：选择「倍数」（1 表示只修复、不放大，最大 4）或「宽高」（直接指定目标尺寸）。
• 「增强模型」：列表读取自您的 Topaz Video AI，每个模型只列出最新版本。
• 「自动估参」：默认开启，由 Topaz 自动估计修复参数；取消勾选后可手动调整「修复压缩」「改善细节」「锐化」「减少噪点」「去光晕」「消除锯齿/去模糊」。
• 「加颗粒」「颗粒大小」：出片后叠加一层颗粒，便于与带颗粒的原片合成。
• 「慢动作」「慢放倍数」：在原有帧之间插入新帧，帧数变为原来的倍数，fps 不变；默认「不慢放」，慢放倍数最大 16。

Topaz 安装在局域网内另一台电脑上时，请在该电脑上同样安装插件（或复制 pixrepaint 文件夹），双击其中的 topaz_service.bat，窗口中将显示端口与口令；然后在每台 Nuke 的「选项…」中填写「Topaz 服务地址」（格式为 http://该电脑的 IP:端口）与「Topaz 服务口令」。Windows 防火墙首次询问时请选择「允许」。关闭该窗口后服务即停止。

单帧放大

Rp I Upscale 在云端对单帧画面进行高清放大：分块重绘补充细节，同时保持原有结构不变。

• 「帧」：要放大的帧号，点击「用当前帧」填入时间线上的当前帧。
• 「放大倍数」：1～4，1 表示尺寸不变、只补充细节。
• 「分块大小」：768 / 1024 / 1280 / 1536，下方显示按当前设置共分为几块。
• 「重绘强度」：数值越大补充的细节越多，0.5 以内原有的五官与图案基本不变。
• 「自动写提示词」：勾选后自动根据画面生成提示词并填回「提示词」框；不勾选则直接使用框内的提示词，处理更快。提示词请使用英文。

该节点只处理单帧，逐帧放大视频会产生闪烁。视频请使用 Rp M Paint Pass2 Upscale 或 Rp Enhance。

单帧改图

Rp I Edit 在云端按一句话指令修改单帧画面，例如替换物体、更换服装或去除元素。source 接原画面，mask 接 roto 标出要修改的区域（不接则修改整张画面），refs 可接最多 9 张参考图（多张请先用 AppendClip 合并）。source 不接时为生成模式：按参考图或纯文字生成新画面。

• 「帧」：要修改的帧号，结果节点也放在这一帧。
• 「改图指令」：用一句话描述要做的修改。
• 「提示词增强」：默认开启，先把指令改写为更详细的描述再生成，改写后的指令填回「改写后的指令」框。用参考图替换遮罩区域的内容时请保持开启。
• 「标记」：设置在送去的画面上如何标示修改区域（原片不受影响）。一般保持默认；修改位置不准，或希望遮罩区域内的内容更自由地重新生成时，可尝试其他选项。
• 「只改遮罩附近」：默认开启，只裁出遮罩附近（按「外拓」扩展）的区域进行修改；勾选「预览裁切框」时，节点输出画面上框外压暗，显示实际送去的范围。
• 「画布」：可按分辨率系数（MP）或放大倍数确定生成尺寸，下方显示实际画布。

完成后生成结果节点；需要贴回原片时，点击结果节点上的「创建回贴节点」。执行超过 30 分钟仍未完成的任务会自动在云端取消，以免持续计费，可调小分辨率系数或减少参考图后重试。

选项与工具

打开 Nodes › pixRepaint › 选项…，可设置以下各项。以下开关均默认关闭，勾选后生效：

• Ctrl+V 粘贴时，如剪贴板中为截图或文件路径，直接创建 Read 节点。
• 复制选中节点并保留上游连线，默认快捷键为 Ctrl+Alt+V，可在面板中更改。
• 拖入或粘贴 mp4、webm、mkv、m4v 视频文件时，先转换为 ProRes 再创建 Read 节点。
• 「显示高级参数」：显示节点面板上的高级参数分组。
• 「使用代理」：插件连接 RunningHub 与许可证服务器时经由下方填写的代理服务器地址（例如 http://127.0.0.1:7890）。不勾选时直连，不受系统代理设置影响。修改后立即生效，无需重启 Nuke。

「Topaz 服务地址」与「Topaz 服务口令」用于 Rp Enhance 调用局域网内另一台电脑上的 Topaz，留空时使用本机安装的 Topaz，详见画质修复与慢动作。

收集文件到工程：pixRepaint 菜单中的工具。将工程中 Read 节点引用的、位于工程目录之外的文件复制到工程目录下的 collected 文件夹，并将这些 Read 节点改为指向新位置；已在工程目录下的文件将跳过。使用前请先保存工程，执行前会显示需复制的文件数量与总大小供您确认。

常见提示信息

联系我们

邮箱 pixRepaint@163.com，淘宝店铺 像素锐绘。购买前的常见问题，请参阅首页常见问题。