Runway API 技能

使用 Runway 的 API 生成 AI 视频、图像和音频。支持 Gen-4.5——Runway 最新、最强大的模型——同时支持文本转视频和图像转视频生成，以及 Gen-4 变体模型和来自 Google（Veo）和 ElevenLabs 的第三方模型。

设置

1. 1. 从 dev.runwayml.com 获取你的 API 密钥
2. 将其作为 RUNWAYMLAPI_SECRET 存储在环境变量中
3. 安装 Node.js SDK：npm install @runwayml/sdk

快速开始

文本转视频（gen4.5）

javascript
import RunwayML from @runwayml/sdk;

const client = new RunwayML(); // 自动读取 RUNWAYMLAPISECRET

const task = await client.textToVideo.create({
model: gen4.5,
promptText: 繁忙小贩中心里一碗热气腾腾的面条，暖光，镜头缓慢推进,
duration: 5,
ratio: 1280:720
}).waitForTaskOutput();

console.log(视频 URL:, task.output[0]);

图像转视频（gen4.5）

javascript
import RunwayML from @runwayml/sdk;
import fs from fs;

const client = new RunwayML();

const imageData = fs.readFileSync(product.jpg);
const promptImage = data:image/jpeg;base64,${imageData.toString(base64)};

const task = await client.imageToVideo.create({
model: gen4.5,
promptImage,
promptText: 缓慢推近产品罐，暖色侧光，透过玻璃可见酱汁闪烁,
duration: 5,
ratio: 1280:720
}).waitForTaskOutput();

console.log(视频 URL:, task.output[0]);

cURL（直接 API）

bash

文本转视频

curl -X POST https://api.dev.runwayml.com/v1/imagetovideo \
-H Authorization: Bearer $RUNWAYMLAPISECRET \
-H X-Runway-Version: 2024-11-06 \
-H Content-Type: application/json \
-d {
model: gen4.5,
promptText: 日落时分宁静的山景,
ratio: 1280:720,
duration: 5
}

可用模型

视频生成

模型	输入	积分/秒	说明
gen4.5 ⭐	文本或图像	12	最新且推荐
gen4_turbo

仅图像 | 5 | 快速 I2V 迭代 | | veo3.1 | 文本或图像 | 40 | Google Veo — 包含音频 | | veo3.1_fast | 文本或图像 | 15 | Veo — 含音频，更便宜 | | gen4_aleph | 视频 + 文本/图像 | 15 | 视频到视频转换 | | act_two | 图像或视频 | 5 | 角色表演/动作 |

图像生成

模型	积分	说明
gen4image	5–8/张	高质量，支持风格参考
gen4image_turbo

2/张 | 快速迭代（需要参考图像） |

音频（通过 Runway 的 ElevenLabs）

模型	输出	积分
elevenmultilingualv2	文本 → 语音	1/50 字符
eleventexttosoundv2

文本 → 音效 | 1/6 秒 | | elevenvoicedubbing | 音频 → 配音 | 1/2 秒 |

有效比例

比例	格式
1280:720	16:9 横向（标准）
720:1280

9:16 纵向（Reels/Stories） | | 1584:672 | 21:9 超宽 | | 1104:832 | 4:3 | | 832:1104 | 3:4 | | 960:960 | 方形 |

时长

• - gen4.5: 2–10 秒
• gen4_turbo: 5 或 10 秒

任务轮询

所有操作均为异步。SDK 的 .waitForTaskOutput() 自动处理轮询（10 分钟超时）。

状态： PENDING → THROTTLED → RUNNING → SUCCEEDED / FAILED

手动轮询：
bash
curl https://api.dev.runwayml.com/v1/tasks/{task_id} \
-H Authorization: Bearer $RUNWAYMLAPISECRET \
-H X-Runway-Version: 2024-11-06

提示技巧

• - 描述单个场景（5–10 秒片段）
• 使用清晰的物理描述，而非抽象概念
• 对于镜头运动：缓慢推进、跟拍、推向主体
• 避免否定表述——不要模糊会产生不可预测的结果
• 保持提示接地气且物理上合理

官方文档

• - Runway API 文档
• 模型指南
• 开发者门户