rw-setup-api-key

设置 API 密钥

指导用户获取 Runway API 密钥、安装 SDK，并配置项目以访问 API。

**前置条件：**先运行 +rw-check-compatibility，确保项目具备服务端能力。

第 1 步：创建 Runway 开发者账户

指导用户执行以下操作：

1. 访问 https://dev.runwayml.com/
2. 创建一个组织（或使用现有组织）
3. 前往 Organization Settings → API Keys
4. 点击 Create API Key
5. 立即复制密钥——密钥只会显示一次，之后无法找回

需要提醒用户的重要事项：

• 丢失的密钥无法找回。如果丢失，请停用旧密钥并创建新密钥。
• API 密钥的作用范围是组织级，而非用户级。
• API 开始工作前，必须预先购买额度。最低购买金额为 $10（1,000 个额度，每个额度 $0.01）。请前往 https://dev.runwayml.com/ 的账单页面购买。

第 2 步：安装 SDK

Node.js

npm install @runwayml/sdk

需要 Node.js 18+。SDK 包含 TypeScript 类型定义。

Python

pip install runwayml

需要 Python 3.8+。包含 MyPy 类型注解。

第 3 步：配置环境变量

SDK 会自动从 RUNWAYML_API_SECRET 环境变量读取 API 密钥。

选项 A：.env 文件（推荐用于开发）

检查项目是否已有 .env 文件。如果有，请在其中追加内容；如果没有，请创建一个。

RUNWAYML_API_SECRET=your_api_key_here

**对于 Node.js 项目：**确保项目会加载 .env 文件：

• Next.js、Remix、Vite——内置 .env 支持，无需额外设置
• Express/Fastify/纯 Node——安装 dotenv：

  npm install dotenv
  

  在入口文件中添加：

  import 'dotenv/config';
  

**对于 Python 项目：**如果使用的框架不提供内置支持，请确保已安装 python-dotenv：

pip install python-dotenv

在入口文件中添加：

from dotenv import load_dotenv
load_dotenv()

选项 B：系统环境变量

export RUNWAYML_API_SECRET=your_api_key_here

选项 C：直接传入客户端（不推荐）

// Node.js
const client = new RunwayML({ apiKey: 'your_api_key_here' });

# Python
client = RunwayML(api_key='your_api_key_here')

**提醒用户：**切勿将密钥硬编码在源代码中。请使用环境变量或密钥管理器。

第 4 步：更新 .gitignore

确保 .env 已添加到 .gitignore，以防意外提交 API 密钥：

.env
.env.local
.env.*.local

检查现有的 .gitignore，如果缺少该条目，请添加。

第 5 步：验证设置

建议用户快速验证设置：

Node.js

import RunwayML from '@runwayml/sdk';

const client = new RunwayML();
// If no error is thrown, the API key is configured correctly
console.log('Runway SDK initialized successfully');

Python

from runwayml import RunwayML

client = RunwayML()
# If no error is thrown, the API key is configured correctly
print('Runway SDK initialized successfully')

第 6 步：确认额度余额

提醒用户：

• API 需要预付额度才能正常使用
• 最低购买金额：$10（1,000 个额度）
• 购买地址：https://dev.runwayml.com/ → Billing
• 用户可以通过 API 查询余额：

// Node.js - check organization info
const response = await fetch('https://api.dev.runwayml.com/v1/organization', {
  headers: {
    'Authorization': `Bearer ${process.env.RUNWAYML_API_SECRET}`,
    'X-Runway-Version': '2024-11-06'
  }
});
const org = await response.json();
console.log('Credits:', org.creditBalance);

安全检查清单

继续操作前，请确认：

• API 密钥存储在环境变量中，而非硬编码在代码里
• .env 文件已添加到 .gitignore
• API 调用只会在服务端执行（不会在浏览器运行的代码中执行）
• 用户已购买额度

后续步骤

配置好 API 密钥后，用户可以继续进行集成：

• +rw-integrate-video — 视频生成（文本转视频、图像转视频）
• +rw-integrate-image — 图像生成
• +rw-integrate-audio — 音频生成（TTS、音效、语音）
• +rw-integrate-uploads — 为需要图像/视频输入的模型上传文件