--- title: 透過 RunAPI 在 WorkBuddy 中使用 Runway — 影片 MCP 指南 | RunAPI description: 透過 RunAPI MCP 伺服器在 WorkBuddy 中使用 Runway Gen-4 生成影片。文字轉影片，5 秒或 10 秒片段，720p/1080p，一個 API 金鑰。 url: https://runapi.ai/zh-HK/workbuddy-runway.md canonical: https://runapi.ai/zh-HK/workbuddy-runway locale: zh-HK site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/workbuddy-runway zh-CN: https://runapi.ai/zh-CN/workbuddy-runway es: https://runapi.ai/es/workbuddy-runway ja: https://runapi.ai/ja/workbuddy-runway de: https://runapi.ai/de/workbuddy-runway fr: https://runapi.ai/fr/workbuddy-runway pt-BR: https://runapi.ai/pt-BR/workbuddy-runway ko: https://runapi.ai/ko/workbuddy-runway it: https://runapi.ai/it/workbuddy-runway nl: https://runapi.ai/nl/workbuddy-runway pl: https://runapi.ai/pl/workbuddy-runway tr: https://runapi.ai/tr/workbuddy-runway zh-TW: https://runapi.ai/zh-TW/workbuddy-runway zh-HK: https://runapi.ai/zh-HK/workbuddy-runway ar: https://runapi.ai/ar/workbuddy-runway x-default: https://runapi.ai/workbuddy-runway model: runway --- > HTML version: https://runapi.ai/zh-HK/workbuddy-runway > Site index for agents: https://runapi.ai/llms.txt # 在 WorkBuddy 中使用 Runway。 Runway Gen-4 可從文字提示或首幀圖片生成 5 秒或 10 秒、720p 或 1080p 的影片。WorkBuddy 原生支援 MCP——將 RunAPI 新增為 MCP 伺服器一次，向工作台 Agent 要求生成影片，它便會呼叫 Runway 工具，等待非同步任務完成，並將影片 URL 傳回對話。以同樣方式使用 Runway Aleph 延伸片段或重新風格化素材。 - [取得 API Key](https://runapi.ai/zh-HK/login) - [閱讀文件](https://runapi.ai/zh-HK/docs/guides) 一個 MCP 伺服器 · 一個 RunAPI 金鑰 · 720p 或 1080p 輸出 ### 提示詞 ```text Generate a video with Runway Gen-4 through the runapi MCP server. Requirements: - Use the runapi MCP server's video generation tool. - Set model to "runway". - Prompt: "A drone shot rising over a misty mountain lake at sunrise, cinematic lighting". - Set duration_seconds to 10 and output_resolution to "1080p". - The task is async — wait for it to complete and give me the video URL. ``` ### MCP 設定 ```bash { "mcp_servers": { "runapi": { "url": "https://runapi.ai/mcp", "transport": "streamable_http", "headers": { "Authorization": "Bearer $RUNAPI_API_KEY" } } } } ``` ### 回應 ```json { "task_id": "tsk_abc123", "status": "completed", "model": "runway", "output": { "video_url": "https://media.runapi.ai/videos/tsk_abc123.mp4" } } ``` ## 三步驟在 WorkBuddy 中使用 Runway 1. **新增 RunAPI MCP 伺服器** - 將 RunAPI 註冊為名為 runapi 的 MCP 伺服器，指向 https://runapi.ai/mcp，Authorization 標頭從 RUNAPI_API_KEY 讀取你的金鑰。若你已將 RunAPI 連接至 WorkBuddy，同一伺服器即會公開 Runway 工具——無需額外設定。 `{ "mcp_servers": { "runapi": { "url": "https://runapi.ai/mcp", "transport": "streamable_http", "headers": { "Authorization": "Bearer $RUNAPI_API_KEY" } } } } ` 2. **提示工作台代理** - 以自然語言向 WorkBuddy 要求 Runway 影片——描述場景，選擇 5 或 10 秒，並選擇 720p 或 1080p。Agent 將你的請求對應至 runapi MCP 伺服器公開的 Runway 工具，如你附上參考圖片亦會包含 first_frame_image_url。 `Generate a 10-second 1080p video with Runway Gen-4: a drone shot rising over a misty mountain lake at sunrise. ` 3. **接收影片 URL** - Runway 任務為非同步處理。WorkBuddy 透過 MCP 伺服器輪詢，直至狀態為 completed，再將輸出影片 URL 傳回對話。如需延伸片段，請 Agent 以 source_task_id 呼叫 extend_video。 `{ "task_id": "tsk_abc123", "status": "completed", "output": { "video_url": "https://media.runapi.ai/videos/tsk_abc123.mp4" } } ` ## Runway 工具參數 | 參數 | 類型 | 說明 | | --- | --- | --- | | `model` | `string` | 必填。Gen-4 請使用 runway，Aleph edit_video 請使用 runway-aleph。 | | `prompt` | `string` | 必填。視頻內容的文字描述——鏡頭運動、場景、燈光。 | | `duration_seconds` | `integer` | 必填。視頻長度：5 或 10 秒。 | | `output_resolution` | `string` | 必填。輸出解析度：720p 或 1080p。影響定價。 | | `first_frame_image_url` | `string` | 選填。用作視頻首幀的圖片 URL。 | | `aspect_ratio` | `string` | 選填。輸出長寬比：16:9、9:16、1:1、4:3 或 3:4。 | ## WorkBuddy 上的 Runway 是什麼？ Runway Gen-4 以快速、精緻、電影感的輸出著稱，動態流暢，提示遵從度高。可從文字提示或參考圖片生成 5 或 10 秒、720p 或 1080p 的片段，世界一致性使角色與環境在鏡頭內保持穩定。WorkBuddy 透過 runapi MCP 伺服器存取——與工作台中其他所有模型共用同一伺服器及 RUNAPI_API_KEY。 ## Runway 使用場景 - **創作者的片頭及 B-roll 素材** - 向 WorkBuddy 要求製作精緻的片頭序列及 YouTube、Instagram 或 TikTok 的 B-roll 素材。Runway 的電影級構圖可從自然語言簡報生成廣播級短片。 - **微型廣告及短片 Reels** - 從工作台製作 5 秒或 10 秒廣告短片及宣傳片段。附上產品圖片作為首幀，Runway 便會以鏡頭運動及自然光效為其製作動畫。 - **電影製作前期視覺化** - 為敘事內容生成概念片段，保持角色一致性。使用參考圖片在正式製作前鎖定角色造型，適用於多個鏡頭。 ## Runway + WorkBuddy 常見問題 ### 我可以在 WorkBuddy 中使用 Runway 影片生成嗎？ 可以。以你的 RUNAPI_API_KEY 將 RunAPI 新增為 MCP 伺服器，Runway 工具便會與所有其他 RunAPI 模型一同出現。向工作台 Agent 提供提示、時長（5 或 10 秒）及解析度（720p 或 1080p），它會代你處理呼叫。 ### Runway Gen-4 與 Runway Aleph 有什麼分別？ Runway Gen-4（model: runway）處理 text_to_video 及 extend_video——從文字或圖片建立新片段。Runway Aleph（model: runway-aleph）處理 edit_video——以文字提示重新風格化現有素材。兩者均由同一 runapi MCP 伺服器公開，WorkBuddy 可按每次請求切換使用。 ### RunAPI 上的 Runway 定價如何運作？ Runway 採用基於 duration_seconds 及 output_resolution 的矩陣計費。5 秒 720p 片段的費用低於 10 秒 1080p 片段。請查閱 RunAPI 定價頁面了解最新費率。按用量付費，無需訂閱。 ### WorkBuddy 會等待影片完成，還是我需要自行輪詢？ 工作台 Agent 會代為處理。Runway 任務為非同步——工具傳回 task_id，WorkBuddy 透過 MCP 伺服器輪詢任務，直至狀態為 completed，再將影片 URL 傳回對話。你無需自行管理輪詢循環。 ### 生成 Runway 視頻後可以延長嗎？ 可以。請 WorkBuddy 延伸片段——Agent 以原始生成的 source_task_id 及新提示呼叫 extend_video。延伸內容附加至現有片段，按 output_resolution 計算每次延伸費用。 - [WorkBuddy 設定指南 →](https://runapi.ai/zh-HK/workbuddy.md) - 尚未連接？請先參閱 WorkBuddy 的 RunAPI MCP 設定指南。 - [Runway on RunAPI →](https://runapi.ai/zh-HK/models/runway.md) - 查看 Runway Gen-4 及 Aleph 變體、定價及 API 文件。 ## 立即在 WorkBuddy 中試用 Runway。 獲取免費 RunAPI 金鑰，將 MCP server 加入 WorkBuddy，即可在工作台內以 Runway Gen-4 生成 720p 或 1080p 電影級影片。 [瀏覽模型 →](https://runapi.ai/zh-HK/models.md) --- ## More from RunAPI - [Home](https://runapi.ai/zh-HK/.md) ### 產品 - [模型目錄](https://runapi.ai/zh-HK/models.md) - [收費](https://runapi.ai/zh-HK/pricing.md) - [服務商](https://runapi.ai/zh-HK/models#all-models) ### 開發者 - [文件](https://runapi.ai/zh-HK/docs/guides) - [SDK](https://runapi.ai/zh-HK/sdk.md) - [CLI](https://runapi.ai/zh-HK/cli.md) - [MCP Server](https://runapi.ai/zh-HK/mcp.md) - [x402](https://runapi.ai/zh-HK/x402.md) ### 指南 - [Claude Code 與 Cursor](https://runapi.ai/zh-HK/claude-code-vs-cursor.md) - [Cursor API 設定](https://runapi.ai/zh-HK/cursor-api-setup.md) - [RunAPI 與 OpenRouter](https://runapi.ai/zh-HK/openrouter-alternative.md) ### 公司 - [企業版](https://runapi.ai/zh-HK/contact.md) - [聯絡](https://runapi.ai/zh-HK/contact.md) ### 法律 - [條款](https://runapi.ai/zh-HK/terms.md) - [私隱](https://runapi.ai/zh-HK/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/zh-HK", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/zh-HK/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/zh-HK", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/zh-HKicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "SoftwareApplication", "name": "適用於 WorkBuddy 的 RunAPI Runway", "applicationCategory": "DeveloperApplication", "description": "透過 RunAPI MCP 伺服器在 WorkBuddy 中使用 Runway Gen-4 生成影片。文字轉影片，5 秒或 10 秒片段，720p/1080p，一個 API 金鑰。", "url": "https://runapi.ai/zh-HK/workbuddy-runway" }, { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "我可以在 WorkBuddy 中使用 Runway 影片生成嗎？", "acceptedAnswer": { "@type": "Answer", "text": "可以。以你的 RUNAPI_API_KEY 將 RunAPI 新增為 MCP 伺服器，Runway 工具便會與所有其他 RunAPI 模型一同出現。向工作台 Agent 提供提示、時長（5 或 10 秒）及解析度（720p 或 1080p），它會代你處理呼叫。" } }, { "@type": "Question", "name": "Runway Gen-4 與 Runway Aleph 有什麼分別？", "acceptedAnswer": { "@type": "Answer", "text": "Runway Gen-4（model: runway）處理 text_to_video 及 extend_video——從文字或圖片建立新片段。Runway Aleph（model: runway-aleph）處理 edit_video——以文字提示重新風格化現有素材。兩者均由同一 runapi MCP 伺服器公開，WorkBuddy 可按每次請求切換使用。" } }, { "@type": "Question", "name": "RunAPI 上的 Runway 定價如何運作？", "acceptedAnswer": { "@type": "Answer", "text": "Runway 採用基於 duration_seconds 及 output_resolution 的矩陣計費。5 秒 720p 片段的費用低於 10 秒 1080p 片段。請查閱 RunAPI 定價頁面了解最新費率。按用量付費，無需訂閱。" } }, { "@type": "Question", "name": "WorkBuddy 會等待影片完成，還是我需要自行輪詢？", "acceptedAnswer": { "@type": "Answer", "text": "工作台 Agent 會代為處理。Runway 任務為非同步——工具傳回 task_id，WorkBuddy 透過 MCP 伺服器輪詢任務，直至狀態為 completed，再將影片 URL 傳回對話。你無需自行管理輪詢循環。" } }, { "@type": "Question", "name": "生成 Runway 視頻後可以延長嗎？", "acceptedAnswer": { "@type": "Answer", "text": "可以。請 WorkBuddy 延伸片段——Agent 以原始生成的 source_task_id 及新提示呼叫 extend_video。延伸內容附加至現有片段，按 output_resolution 計算每次延伸費用。" } } ] }, { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "HowTo", "name": "如何透過 RunAPI 在 WorkBuddy 中使用 Runway", "description": "在 WorkBuddy 中將 RunAPI 新增為 MCP 伺服器，提示工作台 Agent 以時長及解析度控制生成 Runway Gen-4 影片，並接收成品影片 URL。", "step": [ { "@type": "HowToStep", "position": 1, "name": "新增 RunAPI MCP 伺服器", "text": "將 RunAPI 註冊為名為 runapi 的 MCP 伺服器，指向 https://runapi.ai/mcp，Authorization 標頭從 RUNAPI_API_KEY 讀取你的金鑰。若你已將 RunAPI 連接至 WorkBuddy，同一伺服器即會公開 Runway 工具——無需額外設定。", "url": "https://runapi.ai/zh-HK/workbuddy-runway#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "提示工作台代理", "text": "以自然語言向 WorkBuddy 要求 Runway 影片——描述場景，選擇 5 或 10 秒，並選擇 720p 或 1080p。Agent 將你的請求對應至 runapi MCP 伺服器公開的 Runway 工具，如你附上參考圖片亦會包含 first_frame_image_url。", "url": "https://runapi.ai/zh-HK/workbuddy-runway#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "接收影片 URL", "text": "Runway 任務為非同步處理。WorkBuddy 透過 MCP 伺服器輪詢，直至狀態為 completed，再將輸出影片 URL 傳回對話。如需延伸片段，請 Agent 以 source_task_id 呼叫 extend_video。", "url": "https://runapi.ai/zh-HK/workbuddy-runway#how-step-3" } ] }, { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "主頁", "item": "https://runapi.ai/zh-HK" }, { "@type": "ListItem", "position": 2, "name": "適用於 WorkBuddy 的 RunAPI Runway", "item": "https://runapi.ai/zh-HK/workbuddy-runway" } ] } ] ```