安装插件
安装包目前暂不开放公开下载。申请试用审核通过后，我们将向您提供安装包，安装步骤详见安装说明。安装完成后重启 Nuke，菜单中出现 pixRepaint 即表示安装成功。
开始之前
使用插件前，需准备以下两项：
- RunningHub 会员。免费账号无法调用 API，需开通任一档位会员，模型运算在该平台完成。
- pixRepaint 订阅码。待填：淘宝店铺链接购买，或前往申请试用页面获取试用码。
会员费用支付给 RunningHub，订阅费用支付给我们，两者分别结算。
激活插件
请打开 Nodes › pixRepaint › Rp Account...，按下表填写相关信息。
| 字段 | 说明 | 获取方式 | 存储位置 |
|---|---|---|---|
| 订阅码 | 我们发放的订阅凭证，各台机器填写同一订阅码，不会因使用而失效 | 通过淘宝购买或申请试用获取 | 本机 |
| RunningHub API Key | 您本人 RunningHub 账号中的 API Key | RunningHub 个人中心 | 仅保存在本机，不会上传至我们的服务器 |
| 平台用户 ID | 个人中心昵称下方显示的数字，例如 191…4434 | RunningHub 个人中心 | 仅首次激活时需填写，更换机器后无需再次填写 |
| 本机标签 | 为该机器设置的名称，默认「工作站」，用于在座位列表中识别 | 由您自行填写 | 本机 |
| 机器档位 | default / plus / ultra，为 RunningHub 执行任务所使用的机器规格 | 如无特殊需求，保持面板默认值即可 | 本机 |
填写完成后点击确定，插件将自动完成一次激活。
服务状态指示灯
Rp Account 与节点面板上均设有「服务」状态指示灯，含义如下。
- 绿色：已激活，且已成功联系服务器，可正常提交任务。
- 黄色：已激活，但暂时无法联系服务器或已被限流，当前依靠本地缓存的授权继续提交任务。
- 红色：无法提交任务，旁边显示的文字即为具体原因，请据此处理。
首次重绘
请新建一个 Rp M Paint 节点，并完成以下连接：
- source：接入源素材。
- mask：接入灰度遮罩，白色区域为需要重绘的范围；未接入遮罩时将对整帧进行重绘。
- refs：可选，接入参考素材，详见下一节。
强度提供两种模式：统一强度以单一数值控制整块遮罩区域；分级强度通过遮罩灰度控制各区域的重绘强度，可在同一遮罩内实现不同区域的强弱差异。
「传输质量」设有两档：高质量（默认）上传 ProRes 4444 12-bit；快速上传 H.264 10-bit，文件体积更小，由插件内置的 ffmpeg 完成转码。
点击提交后，可在面板上查看进度，任务完成后将在旁边自动创建结果节点。roto 请按工程尺寸绘制，插件会自动等比缩放至生成所需的尺寸。
参考素材和提示词
参考素材统一接入 Rp M Refs，共三个端口，各端口分别接入一个 AppendClip：
- refpic：参考图，最多 9 张。
- anchors：锚点图，按帧号放置于指定位置，提供强引导而非直接贴合，建议间隔 40 帧以上。
- refvid：参考视频，最多 3 段，按 24fps 计算，超过 15 秒的部分将被截断。
提示词中使用以下标签引用素材，编号按接入 AppendClip 的顺序排列，三类分别从 1 开始计数：
| 标签 | 作用 |
|---|---|
<Picture N> | 外观、身份 |
<Video N> | 运动、镜头 |
<Subject N> | 同时提供外观与运动信息 |
例如可先写一句：「<Subject 1> 的外观来自 <Picture 1>，运动来自 <Video 1>」。提示词输入框内置起始模板，【】中为需替换的内容。RunningHub 后端不支持参考音频，提示词中无需填写。
二阶放大
Rp M Paint Pass2 Upscale 接入上一步的结果节点后，将自动沿用提示词、参考素材与锚点，无需重新填写。如需调整，可通过「改提示词」「改参考素材」两个开关分别覆盖。
该节点自身的参数包括：尺寸模式与放大倍数、精修步数、重绘起点。遮罩提供三种模式：不使用（整帧放大）、沿用上一步遮罩、接入新遮罩。
裁切重绘
裁切重绘仅将 roto 周边区域送出运算，适用于区域占画面比例较小的情况，可显著提升清晰度。裁切框提供两种方式：
- A 合并框：整条镜头使用同一个静态框。
- B 跟随框：框逐帧跟随 roto 移动。
回贴步骤需手动生成，请在结果节点上点击「重建裁切 / 回贴节点」。回贴提供「原片不变」「结果不变」两种模式。
结果节点
任务完成后将自动创建一个带输入端口的 Read 节点，label 中标注该任务的耗时。面板上还提供以下功能：
- 「恢复生成节点（当时参数）」，可还原提交时的全部参数。
- Rp Collect Files to Project：将结果与相关素材归集至工程目录。
- Rp Fix Result Frame Range：为旧版结果节点升级帧范围处理方式，修复部分下游节点出现夹帧的问题。
更换机器与授权管理
更换新机器无需重新完成整套激活流程，填写相同的订阅码与 API Key 即可，平台用户 ID 无需再次填写。
旧机器停用后，可前往 Rp Seats 面板查看座位列表并释放对应座位；也可在 Rp Account 中点击「释放本机授权」，在当前机器上直接释放。
Rp Options
以下四项功能均默认关闭，勾选后生效：
- Ctrl+V：将剪贴板中的截图或文件直接创建为 Read 节点。
- 复制节点时保留上游连接，默认快捷键为 Ctrl+Alt+V。
- 拖入 mp4 等视频文件时，先转换为 ProRes 再创建 Read 节点。
- 显示高级参数。
常见提示信息
| 提示信息 | 处理方法 |
|---|---|
| 订阅未开通或已到期，请联系我们 | 请联系我们确认订阅状态。 |
| 平台并发已满，排队中 | 该提示为正常排队状态，无需处理，插件将自动重试。 |
| 平台 RH 币不足 | 请前往 RunningHub 充值或续费会员。 |
| 需要先开通平台会员 | 请前往 RunningHub 开通任一档位会员，免费账号无法调用 API。 |
| 参数和应用对不上，请更新插件 | 请联系我们获取最新版本的安装包。 |
| 内容审核未通过 | 请更换素材或提示词后重试。 |
| 平台任务失败 | 请重新提交任务；如反复失败，请与我们联系。 |
| 许可证服务器不可达，用的是缓存配置 | 本次提交不受影响，联网后将自动刷新。 |
| 授权已过期（离线超过宽限期），请联网重新取配置 | 请联网后打开 Rp Account 刷新授权。 |
| 连不上许可证服务器，本机也没有可用的配置 | 请检查网络连接，或先在 Rp Account 中完成一次激活。 |
联系我们
微信 待填，邮箱 待填。购买前的常见问题，请参阅首页常见问题。