这份指南面向希望把图生视频功能接入应用的开发者。内容根据 Runway 官方文档整理，未执行实际视频生成；如果只需要网页创作，可先查看 Runway 工具介绍。
1. 准备开发者账户与密钥
在 Runway Dev 开发者门户注册账户并创建组织，然后在 API Keys 中创建密钥。密钥只展示一次，应妥善保存。按照官方配置文档设置 RUNWAYML_API_SECRET 环境变量，让 SDK 读取密钥；不要把密钥写入公开代码。调用前还需要确认组织中的 API 点数及当前计费说明。参见 官方账户与密钥配置文档。
2. 选择一种接入方式
下面以 Node.js SDK 为例。安装命令为 npm install --save @runwayml/sdk。随后按照官方完整示例导入 SDK 并建立客户端；如果使用 Python，应直接选用文档中的 Python 示例，不要混用两种语言的参数写法。也可先在官方 Playground 中了解请求结构。
3. 创建图生视频任务
准备可访问的输入图片和描述目标画面的提示词，再按官方示例填写模型、输入图片、提示文本、画面比例及视频时长。示例通过 imageToVideo.create() 创建任务，再使用 waitForTaskOutput() 等待输出。模型和参数支持范围会更新，实际接入时应复制并调整 官方当前示例，不要只凭本文中的方法名称拼接脚本。
4. 核对结果与处理失败
请求提交成功与视频生成完成是两个阶段。检查任务是否成功完成，再打开返回的输出，人工核对画面是否符合输入图片和提示词。若生成失败，按照官方示例捕获任务错误并查看详细信息，定位原因后再决定是否重试，避免重复调用产生额外费用。
资料核对时间：2026-09-04。来源：Runway 官方配置文档与 API 入门指南。
评论