在 Runway 中处理视频项目时，很多操作会反复出现：导入素材、统一命名规范、批量调整参数、按预设导出不同版本。如果完全依靠手动完成，不仅效率低，还容易因为疲劳产生遗漏。Runway 提供了基于 JavaScript 的脚本编写能力，让这些重复任务能够通过代码快速执行。你只需要定义一次流程，之后每次运行脚本就能自动完成整批操作。接下来会从脚本环境、素材遍历、导出自动化以及调试优化几个方面展开，帮助你逐步构建自己的自动化工作流。
一、Runway 脚本环境与基础对象
Runway 的脚本功能以 JavaScript 为核心，既可以在内置脚本编辑器中直接运行，也可以通过 Node.js 脚本调用 Runway 的 API 来完成自动化。两种方式都共享同一套对象模型，核心入口是全局的 runway 对象。通过它可以访问当前项目、素材库、时间线以及导出设置。例如 runway.project.current() 返回当前活动的项目实例，project.assets.list() 则用于读取素材列表。理解这几个基础对象后，后续的批量操作都会围绕它们展开。
下面是一段初始化脚本，用于检查项目是否加载成功，并获取素材总数。代码采用异步函数，符合 Runway API 的调用约定。注意在实际环境中，脚本可能需要配置 API 密钥或访问令牌，具体取决于你使用的是本地插件还是云端 SDK。
const runway = require('runway-sdk');
async function initScript() {
const project = await runway.project.current();
if (!project) {
console.log('没有找到活动项目');
return;
}
const assets = await project.assets.list();
console.log('当前项目素材数量：' + assets.length);
return { project: project, assets: assets };
}
initScript();
运行这段代码后，控制台会输出当前项目的素材数量。相比在界面中逐个查看，脚本可以立即获得结构化数据。Runway 的 API 返回的数据通常是 JSON 格式，字段包括素材名称、类型、时长、标签等。后续处理时，可以基于这些字段做条件筛选，避免对所有素材进行无差别操作。
二、批量遍历素材与条件处理
重复任务中最常见的是对一批素材进行同样的修改，例如给所有未命名的视频片段添加前缀、根据时长或分辨率筛选出需要转码的文件、批量修改标签等。JavaScript 的数组方法如 filter、map、forEach 可以很好地配合 Runway 的列表接口。先通过 assets.list() 获取完整数组，再用条件函数筛选目标，最后逐个执行更新操作。
批量重命名是比较直观的起点。假设项目中有一批无人机拍摄的原始片段，命名均为默认的 clip_001 之类，现在要统一改为 drone_场景_序号 的格式。下面的代码演示了完整流程：读取素材、过滤出视频类型、生成新名称并调用 asset.rename() 保存。注意在修改前记录原始名称，以便出现问题时回滚。
async function batchRename(project, prefix) {
const assets = await project.assets.list({ type: 'video' });
const targetAssets = assets.filter(function(asset) {
return asset.name.indexOf(prefix) !== 0;
});
for (let i = 0; i < targetAssets.length; i++) {
const asset = targetAssets[i];
const oldName = asset.name;
const newName = prefix + '_' + (i + 1);
console.log('重命名：' + oldName + ' -> ' + newName);
await asset.rename(newName);
}
return targetAssets.length;
}
条件筛选还可以结合素材元数据，例如只处理时长超过 10 秒且未标记为成品的片段。这样做能避免误改已经完成的内容。Runway 的素材对象通常提供 duration、width、height、tags 等属性。例如用 asset.duration > 10 判断时长，用 tags.indexOf('final') === -1 排除成品。将筛选逻辑与更新操作分离，脚本会更容易维护。
三、自动化导出任务与状态跟踪
导出是视频制作中最耗时的重复环节之一。一个项目往往需要输出多个版本，例如不同分辨率、不同码率，或者针对不同平台的竖版和横版。手动设置导出参数并逐个提交任务非常繁琐，而且容易遗漏。通过脚本可以读取预设模板，批量创建导出任务，并在后台自动跟踪进度。
下面的代码展示了如何为一个项目中的主时间线批量提交多个导出任务。预设以数组形式定义，每个预设包含分辨率、帧率、格式等信息。调用 project.exports.create() 后，Runway 会返回任务 ID，脚本可以继续轮询任务状态，直到全部完成或失败。这里使用 setTimeout 实现了简单的等待逻辑，实际项目中建议使用 SDK 提供的事件或 Webhook。
const presets = [
{ name: 'web_1080p', width: 1920, height: 1080, format: 'mp4' },
{ name: 'social_square', width: 1080, height: 1080, format: 'mp4' },
{ name: 'mobile_vertical', width: 1080, height: 1920, format: 'mov' }
];
async function batchExport(project, timelineId) {
const taskIds = [];
for (let i = 0; i < presets.length; i++) {
const task = await project.exports.create({
timelineId: timelineId,
preset: presets[i]
});
taskIds.push(task.id);
console.log('已提交导出：' + presets[i].name + '，任务 ID：' + task.id);
}
while (taskIds.length > 0) {
await new Promise(function(resolve) { setTimeout(resolve, 5000); });
for (let j = taskIds.length - 1; j >= 0; j--) {
const status = await project.exports.getStatus(taskIds[j]);
if (status === 'completed' || status === 'failed') {
console.log('任务完成或失败：' + taskIds[j] + '，状态：' + status);
taskIds.splice(j, 1);
}
}
}
}
错误处理在自动导出中不可忽视。网络波动、磁盘空间不足、预设参数不合法都可能导致任务失败。脚本应该捕获每一次 create() 调用的异常，记录失败原因并继续处理下一条，而不是直接中断。可以为每个任务设置最大重试次数，例如失败后等待 30 秒重新提交一次。如果连续失败三次，则将该任务写入单独的日志文件，便于人工排查。这样的机制让脚本可以在无人值守时稳定运行。
四、脚本调试技巧与性能优化
刚开始编写 Runway 脚本时，建议先在小范围内测试。可以先获取一个素材并打印它的完整字段，确认属性名称和数据类型。例如 console.log(JSON.stringify(asset, null, 2)) 可以将对象格式化输出，帮助快速定位字段。不要直接在大型项目上运行未经验证的批量操作，否则一旦逻辑错误，可能会修改大量素材，且难以恢复。可以先用 filter 限定只处理前三个素材，验证通过后再去掉限制。
性能优化方面，应尽量减少对 Runway API 的频繁调用。例如不要在 forEach 循环中每次都重新获取项目实例，而是在循环外保存引用。对于可以并行执行的操作，可以使用 Promise.all 同时提交多个任务，但要注意 API 的频率限制和服务器负载。如果一次性提交几十个导出任务，可能会导致排队甚至触发限流，此时更适合使用并发池控制同时执行的数量，例如每次只处理 5 个。
最后，把常用操作封装成独立函数或模块，能显著提升脚本的复用性。你可以维护一个 automation.js 文件，包含重命名、筛选、导出、日志记录等通用功能。每次遇到新的重复任务时，只需组合这些函数，而不是从头编写。随着积累，你的 Runway 自动化脚本库会越来越完善，日常制作中的重复劳动也会越来越少。
Runway脚本JavaScript自动化重复任务修改时间：2026-08-26 06:43:50