Runway 视频 API 配置
Runway 是视频生成平台。它通常不是填进 Chatbox 的 Base URL，而是在 Runway 平台创建 API Key，然后用官方 SDK 或 HTTP 请求创建视频任务。
官方信息 下载和文档以官方站点为准
适合什么场景
文生视频图生视频异步任务官方 SDK
先理解视频任务流程
- 创建 API Key，并确认账号有视频 API 权限和余额。
- 选择任务类型：文生视频、图生视频，或官方文档当前支持的其他视频任务。
- 提交任务后不会立刻拿到视频文件，通常会先得到任务对象或任务 ID。
- 等待任务完成，再读取输出地址或下载结果。
- 失败时先看任务状态和错误详情，不要只检查 Key。
准备参数
| 配置项 | 填写方式 |
|---|---|
| API Key | Runway 后台创建；官方 SDK 默认读取 <code>RUNWAYML_API_SECRET</code> |
| Task | text-to-video / image-to-video |
| Prompt | 视频内容描述 |
| Ratio / Size | 横版、竖版或指定尺寸 |
| Duration | 视频时长 |
| Status | 轮询任务直到完成 |
| 字段 | 说明 | 新手建议 |
|---|---|---|
| API Key | 请求 Runway API 的凭证 | 只保存在本机或服务器环境变量里，变量名使用 RUNWAYML_API_SECRET |
| Prompt | 视频内容描述 | 先写短一点，确认风格后再细化 |
| Image | 图生视频的起始图 | 上传清晰、主体明确的图 |
| Duration | 视频秒数 | 先用较短时长测试成本和效果 |
| Status | 任务状态 | 视频生成是异步的，需要等待完成 |
SDK 示例
Runway 环境变量名称
RUNWAYML_API_SECRET=你的_Runway_API_KeyRunway Node.js 任务示例
import RunwayML, { TaskFailedError } from "@runwayml/sdk"; const client = new RunwayML(); try { const task = await client.imageToVideo.create({ model: "gen4.5", promptText: "一段产品介绍视频，白色背景，镜头缓慢推进", ratio: "1280:720", duration: 5 }).waitForTaskOutput(); console.log(task.output[0]); } catch (error) { if (error instanceof TaskFailedError) { console.error(error.taskDetails); } }视频平台的字段会随模型版本更新。页面示例用于理解配置结构，真实字段以官方文档当前版本为准。
| 现象 | 优先检查 | 处理 |
|---|---|---|
| 提交后没有立刻返回视频 | 任务是否仍在排队或生成中 | 视频生成是异步任务，等状态完成后再取结果 |
| 任务失败 | 模型名、比例、时长、输入图是否符合当前模型要求 | 按返回的错误详情调整参数，不要一次改很多项 |
| 扣费高于预期 | 时长、分辨率、模型版本 | 先用短时长和低成本参数测试，再批量生成 |