Runway Ruby 实操：把定稿的 SDR 视频转成 HDR 交付版

一条定稿的 SDR 视频，怎么补出 HDR 交付版

交付渠道开始要求 HDR 版本，而手里只有一条已经定稿的 SDR 视频——以前这意味着进达芬奇搭一条 HDR 调色管线，现在 Runway 把这件事做成了模型级操作。Ruby 是 Runway 内置的视频调色模型，不重新生成画面，只把亮度和色彩范围扩展进 HDR 余量，输出 HDR10、HLG、ProRes 或 16-bit EXR 序列。这篇教程依据 Runway 官方帮助中心《Creating HDR videos with Runway Ruby》与 Runway Dev API 更新日志整理，把 Tool Mode、Session、Workflows、API 四条转换路径逐一走一遍，顺带说清输出格式怎么选、哪些输入会被直接拒绝。它是AI 视频教程系列的一篇，Runway 的产品档案见这里。

Ruby 转的是范围，不是画面

先划清能力边界，这决定了你该不该用它。官方帮助中心对 Ruby 的定义是「Runway 原生视频调色模型」：输入任意 SDR 视频，输出真 HDR。它能吃三类素材——Runway 里任意模型生成的视频、第三方模型的输出、你自己上传的现有视频文件。它不重绘任何一帧，源画面的像素和音频都保持原样。

Runway Dev 的 API 更新日志对转换机制有一句很完整的描述，原文如下：

The conversion preserves the source's own pixels and audio: brightness is extended into HDR headroom with a bounded, color-preserving grade, and nothing is re-rendered.
（转换保留源视频自身的像素与音频：亮度以有界的、保色的调色方式扩展进 HDR 余量，不重新渲染任何内容。—— Runway Dev API Changelog，2026-08-20）

换句话说，Ruby 是 finishing 步骤而不是生成步骤。画面里的问题（穿帮、抖动、构图）它一概不管，也别指望它把糊的变清楚。它做的事只有一件：把已经满意的 SDR 成片，包装成符合 HDR 交付规格的文件。

Runway 官方 Ruby 入门视频的封面帧，模型主视觉（图源：Runway 帮助中心附件）

动手前要对齐的四件事

账号档位。帮助中心规格表写明 Ruby 需要 Max plan or higher，所有 Runway Dev 账号可用；网页版 changelog 上对应条目标注的是 Pro+ Plans。两处口径不完全一致，开通前以官方页面显示为准。规格表还单列了一行「Unlimited support: No」——无限量套餐不覆盖这个模型，转换按秒扣积分。

计费。API 更新日志给的数字是每秒视频 20 积分；源分辨率超过 4 百万像素（约 4K）时涨到每秒 40 积分。按 10 秒素材算就是 200 积分起，转换前先看好素材时长。

输入限制。三条硬规则，来自 API 更新日志：输入必须是 SDR，带 HDR 标记的视频会被直接拒绝；最长 30 秒；单边不超过 4096 像素。素材超长就先剪再转。

源质量。帮助中心的建议原文是「For the highest fidelity, start with the cleanest SDR source available」——从最干净的 SDR 源出发，高码率输入换来更准的转换结果。压得很烂的源转出来只会放大瑕疵。

路径一：Tool Mode 里直接上传转换

这是最短路径，适合素材根本不是 Runway 生成的场景——手机拍的、相机拍的、别的模型出的，都从这里进。2026 年 8 月 31 日的更新把 Ruby 独立成了 Tool Mode 模型选择器里的一个模型，带专属界面：

Ruby is now available as its own model in the Tool Mode model selector, with a dedicated UI. Bring in videos from outside Runway and color-grade them with Ruby.
（Ruby 现已在 Tool Mode 模型选择器中作为独立模型提供，配有专属界面。把 Runway 之外的视频带进来，用 Ruby 调色。—— Runway Changelog，2026-08-31）

操作只有四步：

1. 进入 Tool 模式，在视频模型选择器里选 Ruby；
2. 点 Upload 从本地上传视频，或点 Select 从资产库里挑一条；
3. 在 Output format 里选输出格式（后面有对照表）；
4. 点 Generate 开始转换。

转换完成后从输出区下载即可。这条路不经过任何生成步骤，进来什么画面，出去还是什么画面，只是动态范围变了。帮助中心 FAQ 对「不是 Runway 生成的视频能不能转」的回答就是指向这条路：可以，无论是其他生成模型的输出、相机素材还是现有素材库里的文件。

路径二：Session 里生成完顺手转

如果素材本来就要在 Runway 里生成，有两个更顺手的入口，都在会话（Session）里，区别只在时机。

生成前预设：在 Tool Mode 选好模型、填好输入后，展开设置栏里的 HDR 选项，会弹出「Convert with Runway Ruby」菜单；选定格式后，生成一完成转换立即自动开始，不用守着等。适合已经确定要 HDR 交付、不想中间多停一步的情况。

生成后补转：视频已经出来了，先看过了、满意了，再点输出下方的 HDR 按钮，选格式即转。想先看 SDR 效果再决定要不要花这笔积分的，走这条路。

路径三：Workflows 里挂一个 Convert to HDR 节点

要批量转、或者转换只是固定管线里其中一环的，把 Ruby 做成工作流节点更省事。官方对 Workflows 的定位说明是「为媒体生成提供节点式方法，对创作流程的每一步都有细粒度控制」，适合串联多次生成、做成可复用模板、自动化重复操作的场景。

没接触过节点画布的，三个概念就够上手。节点（node）是画布上的功能卡片，官方分四类：输入节点（手动输入文本或上传素材）、媒体模型节点（跑生成模型，消耗积分）、LLM 节点（动态改写提示词）、媒体工具节点（拼接、抽帧、加音频这类编辑操作）。卡片的输入端口都在左侧、输出端口都在右侧。端口按内容类型标色，官方配色是：橙色 Text、蓝色 Image、黄色 Audio、绿色 Video——连线只能连兼容类型，比如 Text 输出连 Text 输入。带星号的是必填端口（如 Prompt*），不连上节点跑不起来。

刚拖进画布、还没连线的节点长这样：

Runway Workflows 画布：Text 输入节点与 Gen-4 Image / Gen-4 Video 生成节点尚未连线时的状态（图源：Runway 帮助中心）

官方帮助中心给的挂节点流程，五步：

1. 在画布上右键（或点左侧的 + 号）；
2. 搜索 Convert to HDR - Ruby 节点，添加到画布；
3. 把上游视频输出连到该节点的输入端口；
4. 打开节点的 Settings，选择 Output format；
5. 运行节点。

端口的星号标注和颜色区分，官方文档里有专门的标注图：

官方文档对节点输入（左）与输出（右）端口的标注说明，必填项带星号（图源：Runway 帮助中心）

连好之后，一条「提示词 → 出图 → 出视频 → 转 HDR」的完整管线就串起来了。官方的示例工作流是把 Text、Gen-4 Image、Gen-4 Video 连成一条链，Ruby 节点用同样的方式接在最下游：

连线完成的示例工作流：提示词 → Gen-4 Image → Gen-4 Video，Ruby 节点以同样方式接入最下游（图源：Runway 帮助中心）

两个省积分的官方机制值得知道。一是锁定节点：点节点右上角的 ... 菜单选 Lock node，该节点的输出就被冻结，重跑整条工作流时不会重新生成——上游视频已经满意时把它锁住，之后反复调 Ruby 的输出格式重跑，烧的只有转换那一截的积分。二是单节点运行：除了右上角的 Run all 跑全程，每个节点自带 Run 按钮，官方明确说这适合测试、排错和只重跑管线的一部分。

画布操作补充几条官方说明：滚轮缩放、点住空白处拖动平移、按住 Shift 拖框选、Mac 按住 Cmd（Windows 按住 Ctrl）点选多个节点；删除节点是选中后按 Backspace；想换掉某个节点不用删了重加，点右上角 ... 菜单里的 Swap node，从兼容节点里挑一个替换，没有兼容项时这个选项不会出现。撤回操作是 Mac 按 Cmd + Shift + ?、Windows 按 Ctrl + Shift + ? 调出完整快捷键列表。另外画布左侧有 Templates 面板，官方预置了文生图、Aleph 2.0 编辑、提示词增强、动捕生成视频等连好线的模板，加进来改改提示词和设置就能用——不确定管线怎么搭时，从模板起步比从零连快得多。

输出格式怎么选

帮助中心规格表列出的全部输出格式与位深如下：

两条选择原则。交付给平台播放选 HDR10（默认）或 HLG，拿到的就是成品文件；后续还要进剪辑或合成，选 ProRes 或 EXR。两种 EXR 的区别，帮助中心 FAQ 的原文是：

Both deliver 16-bit half-float EXR sequences. The ACEScg formats are scene-referred in the ACEScg working space, built for ACES-configured compositing and grading pipelines. The Linear BT.2020 format is display-referred linear light in the BT.2020 gamut.
（两者都是 16-bit 半精度浮点 EXR 序列。ACEScg 是场景参考的 ACEScg 工作空间，为 ACES 配置的合成调色管线而生；Linear BT.2020 是 BT.2020 色域下的显示参考线性光。—— Runway 帮助中心 FAQ）

管线跑的是 ACES 配置就选对应版本的 ACEScg（1.3 或 2.0，匹配你管线的配置版本），否则 Linear BT.2020 是合成场景的默认起点。官方补充了一个很实际的细节：ACEScg 输出是打包成 ZIP 的半精度浮点 EXR 帧序列，颜色度学与来源信息以边车文件附带，源带音频时附 audio.wav，解压后直接进工具，不需要额外转换步骤。

还没生成的镜头，可以直接出 HDR

上面的路径都假设素材已经是 SDR。如果镜头还没生成、而且明确知道要 HDR 交付，有一步到位的走法：Gen-4.5 的文生视频和图生视频支持直接以 HDR 格式输出，不用先出 SDR 再转。更新日志的原话是「HDR outputs are true HDR renders — graded into BT.2020 with measured HDR10 metadata — not tone-mapped afterward」（HDR 输出是真 HDR 渲染，直接分级进 BT.2020 并带实测 HDR10 元数据，不是事后色调映射）。

怎么分岔：新镜头、能接受重新生成，用 Gen-4.5 直出；已有 SDR 定稿、一个像素都不想动，用 Ruby 转。还有一条组合拳在官方文档里写明了——Aleph 2.0 的编辑结果想要 HDR 交付，链到 /v1/video_to_hdr 走 Ruby。另外这批 HDR 格式「正在按账号逐步开放」（These formats are being enabled progressively per account），自己账号上找不到某个格式时先确认开通状态，别急着排查代码。

PQ 和 HLG 挑哪个

选 HDR10 还是 HLG，本质是选两种不同的传递函数。Runway 官方学院课程《Getting Started with Runway Ruby》把 SDR 到 HDR 的转换拆成三个组成部分——位深（bit depth）、BT.2020 色彩、传递函数（transfer function）——并且专门用了一章讲「PQ vs HLG」的取舍，课程的章节目录是：Why HDR matters for delivery → The three parts of SDR to HDR conversion → PQ vs HLG → Generating and converting in Runway → Checking your outputs。

两条背景知识帮你做决定。HDR10 基于 PQ 传递函数，亮度按绝对值编码，点播平台和流媒体交付普遍采用它，也是 Ruby 的默认输出；HLG 的传递函数与常规 SDR 广播链路兼容，老设备不换也能出画面，电视广播场景更常见。拿不准时先用默认的 HDR10，交付方明确要求 HLG 再切——反正源文件还在，重转一次只是再花一遍积分的事。

走 API 的那条路

要接进自家系统的，走 POST /v1/video_to_hdr 端点。API 更新日志写明的关键参数：model 固定为 ruby；outputFormat 可选 hdr10（默认）、hlg、hdr_prores、hdr_exr_sequence，ACES 管线另有 hdr_exr_acescg_sequence_1_3 与 hdr_exr_acescg_sequence_2_0 两个值；选 ProRes 时用 proresProfile 指定档位——422、422 HQ、4444，默认 422 HQ。

前文反复出现的硬限制也来自这条端点的说明，这里归拢成一张速查：输入必须 SDR（带 HDR 标记直接拒）；最长 30 秒；单边 4096 像素以内；计价 20 积分每秒，源超 4 百万像素（约 4K）时 40 积分每秒；输出为 HEVC、ProRes .mov 或 EXR 序列 ZIP 三种容器。

屏幕看不出来 HDR，不是转坏了

官方文档专门有一节讲查看环境：很多外接显示器和普通屏幕无法准确呈现 HDR 内容。如果你的屏幕不支持，Runway 会在应用内给出警告——文件仍然可以生成和下载，但预览反映不了真实 HDR 效果。官方给的三条查看建议：用较新的 MacBook（内置屏幕对 HDR 的呈现较好）；把文件下载下来用专业播放器看，而不是在浏览器里看；外接评估前先确认显示器支持 HDR10 或 HLG。

这条要特别当心：在普通 SDR 屏幕上对比转换前后的文件，差异看起来可能微乎其微，据此判断转换失败是错误结论。判断依据应该是文件本身的元数据（HDR10 静态元数据、位深、色域标记），或者干脆换一台支持 HDR 的设备。

来源

本文步骤与图片依据 Runway 帮助中心《Creating HDR videos with Runway Ruby》《Introduction to Workflows》、Runway 网页版 Changelog 及 Runway Dev API Changelog 整理，版权归原作者所有。积分与档位信息以官方页面实时显示为准。