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); } }視頻平臺的字段會隨模型版本更新。頁面示例用於理解配置結構，真實字段以官方文檔當前版本為準。
| 現象 | 優先檢查 | 處理 |
|---|---|---|
| 提交後沒有立刻返回視頻 | 任務是否仍在排隊或生成中 | 視頻生成是異步任務，等狀態完成後再取結果 |
| 任務失敗 | 模型名、比例、時長、輸入圖是否符合當前模型要求 | 按返回的錯誤詳情調整參數，不要一次改很多項 |
| 扣費高於預期 | 時長、分辨率、模型版本 | 先用短時長和低成本參數測試，再批量生成 |