Runway API 技能

使用 Runway 的 API 生成 AI 视频、图像和音频。支持 Gen-4.5 —— Runway 最新且能力最强的模型，涵盖文本生成视频（text-to-video）与图像生成视频（image-to-video），同时兼容 Gen-4 系列变体，以及来自 Google（Veo）和 ElevenLabs 的第三方模型。

配置

1. 前往 dev.runwayml.com 获取您的 API 密钥
2. 将密钥以环境变量形式存储为 RUNWAYML_API_SECRET
3. 安装 Node.js SDK：npm install @runwayml/sdk

快速开始

文本生成视频（gen4.5）

import RunwayML from "@runwayml/sdk";

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

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

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

图像生成视频（gen4.5）

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）

# 文本生成视频
curl -X POST "https://api.dev.runwayml.com/v1/image_to_video" 
  -H "Authorization: Bearer $RUNWAYML_API_SECRET" 
  -H "X-Runway-Version: 2024-11-06" 
  -H "Content-Type: application/json" 
  -d '{
    "model": "gen4.5",
    "promptText": "日落时分宁静的山景",
    "ratio": "1280:720",
    "duration": 5
  }'

可用模型

视频生成

图像生成

音频（通过 Runway 调用 ElevenLabs）

支持的宽高比

视频时长

• gen4.5： 2–10 秒
• gen4_turbo： 5 或 10 秒

任务轮询

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

任务状态流转： PENDING → THROTTLED → RUNNING → SUCCEEDED / FAILED

手动轮询示例：

curl "https://api.dev.runwayml.com/v1/tasks/{task_id}" 
  -H "Authorization: Bearer $RUNWAYML_API_SECRET" 
  -H "X-Runway-Version: 2024-11-06"

提示词撰写建议

• 描述单一场景（适合 5–10 秒片段）
• 使用明确的物理性描述，避免抽象概念
• 描述镜头运动时，可使用“缓慢推近（slow dolly-in）”、“跟拍镜头（tracking shot）”、“向主体推进（push toward subject）”等术语
• 避免使用否定式表达 —— 如“无模糊（no blur）”会导致不可预测的结果
• 保持提示词具备现实物理基础，符合常理

官方文档

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