--- title: 透過 RunAPI 在 WorkBuddy 使用 Luma — Video MCP 指南 | RunAPI description: 透過 RunAPI MCP server 在 WorkBuddy 使用 Luma Ray 3.2 修改影片。提示詞驅動的轉換可維持空間一致性，只需一組 API key。 url: https://runapi.ai/zh-TW/workbuddy-luma.md canonical: https://runapi.ai/zh-TW/workbuddy-luma locale: zh-TW site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/workbuddy-luma zh-CN: https://runapi.ai/zh-CN/workbuddy-luma es: https://runapi.ai/es/workbuddy-luma ja: https://runapi.ai/ja/workbuddy-luma de: https://runapi.ai/de/workbuddy-luma fr: https://runapi.ai/fr/workbuddy-luma pt-BR: https://runapi.ai/pt-BR/workbuddy-luma ko: https://runapi.ai/ko/workbuddy-luma it: https://runapi.ai/it/workbuddy-luma nl: https://runapi.ai/nl/workbuddy-luma pl: https://runapi.ai/pl/workbuddy-luma tr: https://runapi.ai/tr/workbuddy-luma zh-TW: https://runapi.ai/zh-TW/workbuddy-luma zh-HK: https://runapi.ai/zh-HK/workbuddy-luma ar: https://runapi.ai/ar/workbuddy-luma x-default: https://runapi.ai/workbuddy-luma model: luma --- > HTML version: https://runapi.ai/zh-TW/workbuddy-luma > Site index for agents: https://runapi.ai/llms.txt # 在 WorkBuddy 使用 Luma。 Luma Ray 3.2 可透過提示詞驅動的轉換修改現有影片，同時維持空間一致性與 3D 場景結構。WorkBuddy 原生支援 MCP — 只要將 RunAPI 新增為 MCP server 一次，再將來源影片 URL 提供給工作台 agent 並描述轉換需求。它會呼叫 Luma 工具、等待非同步 task，並回傳具有氛圍光線與物理一致攝影機運動的重新渲染影片。 - [取得 API Key](https://runapi.ai/zh-TW/login) - [閱讀說明文件](https://runapi.ai/zh-TW/docs/guides) 一個 MCP server · 一組 RunAPI key · 非同步 task 處理 ### 提示詞 ```text Modify a video with Luma Ray 3.2 through the runapi MCP server. Requirements: - Use the runapi MCP server's video modification tool. - Set model to "luma-modify-video". - Source video: https://example.com/park-walk.mp4 - Transformation: "Transform the scene into a foggy autumn morning with golden light filtering through trees". - The task is async — wait for it to complete and give me the modified 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": "luma-modify-video", "output": { "video_url": "https://media.runapi.ai/videos/tsk_abc123.mp4" } } ``` ## 三個步驟在 WorkBuddy 使用 Luma 1. **新增 RunAPI MCP server** - 在 WorkBuddy 中註冊名為 runapi 的 MCP server，指向 https://runapi.ai/mcp，並讓 Authorization header 從 RUNAPI_API_KEY 讀取你的 key。若你已將 RunAPI 連線至 WorkBuddy，同一個 server 已提供 Luma 工具，無須額外設定。 `{ "mcp_servers": { "runapi": { "url": "https://runapi.ai/mcp", "transport": "streamable_http", "headers": { "Authorization": "Bearer $RUNAPI_API_KEY" } } } } ` 2. **提示工作台 agent** - 向 WorkBuddy 提供來源影片 URL，並以自然語言描述轉換內容 — 氛圍、光線、風格或場景編輯。agent 會將你的需求對應至 Luma modify_video 工具，並將 model 設為 luma-modify-video；Luma 會在套用變更時保留原始場景幾何結構。 `Restyle https://example.com/park-walk.mp4 with Luma: a foggy autumn morning with golden light filtering through trees. ` 3. **取得修改後的影片** - Luma task 為非同步。WorkBuddy 會透過 MCP server 輪詢，直到狀態為 completed，接著將重新渲染影片 URL 發布至你的對話中。一般處理時間依複雜度而定，約為 30-120 秒。 `{ "task_id": "tsk_abc123", "status": "completed", "output": { "video_url": "https://media.runapi.ai/videos/tsk_abc123.mp4" } } ` ## Luma modify_video 工具參數 | 參數 | 類型 | 說明 | | --- | --- | --- | | `model` | `string` | 必填。使用 luma-modify-video。 | | `prompt` | `string` | 必填。描述所需影片轉換效果的文字，包含風格變化、光線、氛圍或場景編輯。 | | `source_video_url` | `string` | 必填。要修改的來源影片 URL。必須是可公開存取的 MP4 或 MOV 檔案。 | | `watermark` | `boolean` | 選填。是否在輸出影片上加浮水印。 | | `callback_url` | `string` | 選填。task 完成時接收 POST 的 webhook URL。 | | `task_id` | `string` | 由工具回傳。WorkBuddy 使用它輪詢非同步 task，直到修改後的影片準備完成。 | ## WorkBuddy 上的 Luma 是什麼？ Luma Ray 3.2（Dream Machine）專長於以夢幻質感修改現有影片，使用者形容其具有電影感且便於快速迭代。它不會從零生成，而是透過提示詞驅動的轉換重新渲染來源素材 — 氛圍變化、風格轉換與環境變更 — 同時保留原始空間配置與攝影機運動。WorkBuddy 透過 runapi MCP server 存取它；這與工作台中所有其他 model 使用的是相同 server 和 RUNAPI_API_KEY。 ## Luma 使用情境 - **氛圍短片與音樂影片美學** - 請 WorkBuddy 使用 Luma 的夢幻視覺品質，將原始素材轉換為風格化的情緒短片。在保留原始動態的同時變更光線、氛圍和色彩配置，適合音樂影片概念或藝術專案。 - **廣告方向的快速視覺假設驗證** - 在單一工作台對話中，將既有產品影片重新設計為多種視覺方向 — 電影感、極簡、黑色電影或季節風格 — 以測試哪種外觀最適合，再決定是否進行完整重拍。 - **多工具流程的基礎素材** - 使用 Luma 重新設計生成或實拍素材的風格，再讓 WorkBuddy 在同一個工作階段中將結果傳遞給其他 RunAPI 工具。Luma 的快速回應使其適合作為大型影片 pipeline 中的風格化步驟。 ## Luma + WorkBuddy 常見問題 ### Luma 在 WorkBuddy 中可以進行哪些轉換？ Luma modify_video 可透過提示詞驅動的變更重新渲染既有素材 — 氛圍變化（霧、雨、黃金時刻）、風格轉換（電影感、anime、noir）、光線全面調整和環境轉換。它會保留原始攝影機運動與空間配置，WorkBuddy 只需根據自然語言提示詞即可完成操作。 ### Luma 與 RunAPI 上其他影片模型有何不同？ Luma 專長於修改既有影片，而非從零生成。其 Ray 3.2 model 可在轉換期間維持 3D 空間一致性，因此物件會保有深度關係，攝影機運動也會維持物理一致。Kling 或 Hailuo 等 model 可從文字或圖片生成新影片 — 全都可透過同一個 runapi MCP server 存取。 ### WorkBuddy 會等待結果，還是我必須自行輪詢？ 由工作台 agent 處理。Luma task 為非同步 — 工具會回傳 task_id，WorkBuddy 透過 MCP server 輪詢 task，直到狀態為 completed，再將修改後的影片 URL 發布至你的對話中。一般處理時間為 30-120 秒。 ### RunAPI 上 Luma 影片修改的費用為何？ Luma 採用固定單次任務計費——每次 modify_video 呼叫收取固定費用，與影片長度無關。請查看 RunAPI 定價頁面了解目前費率。生成失敗不收費。 ### 我可以在同一個 WorkBuddy 工作階段中，將 Luma 與其他 RunAPI video model 串接嗎？ 可以。請 WorkBuddy 使用 Kling 或 Hailuo 生成影片，再將輸出 URL 作為 source_video_url 傳給 Luma modify_video 進行後製處理 — 全程透過同一個 runapi MCP server 與 RUNAPI_API_KEY，在單一對話中完成。 - [WorkBuddy 設定指南 →](https://runapi.ai/zh-TW/workbuddy.md) - 尚未連線嗎？請先參閱 WorkBuddy 的 RunAPI MCP 設定指南。 - [Luma on RunAPI →](https://runapi.ai/zh-TW/models/luma.md) - 查看 Luma 變體、定價及 API 文件。 ## 立即在 WorkBuddy 試用 Luma。 取得免費 RunAPI key，將 MCP server 新增至 WorkBuddy，無須離開工作台即可開始使用 Luma Ray 3.2 的空間感知轉換來修改影片。 [瀏覽模型 →](https://runapi.ai/zh-TW/models.md) --- ## More from RunAPI - [Home](https://runapi.ai/zh-TW/.md) ### 產品 - [模型目錄](https://runapi.ai/zh-TW/models.md) - [價格](https://runapi.ai/zh-TW/pricing.md) - [提供商](https://runapi.ai/zh-TW/models#all-models) ### 開發者 - [文件](https://runapi.ai/zh-TW/docs/guides) - [SDK](https://runapi.ai/zh-TW/sdk.md) - [CLI](https://runapi.ai/zh-TW/cli.md) - [MCP Server](https://runapi.ai/zh-TW/mcp.md) - [x402](https://runapi.ai/zh-TW/x402.md) ### 指南 - [Claude Code 與 Cursor](https://runapi.ai/zh-TW/claude-code-vs-cursor.md) - [Cursor API 設定](https://runapi.ai/zh-TW/cursor-api-setup.md) - [RunAPI 與 OpenRouter](https://runapi.ai/zh-TW/openrouter-alternative.md) ### 公司 - [企業版](https://runapi.ai/zh-TW/contact.md) - [聯絡我們](https://runapi.ai/zh-TW/contact.md) ### 法律 - [服務條款](https://runapi.ai/zh-TW/terms.md) - [隱私權](https://runapi.ai/zh-TW/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "zh-TW", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/zh-TW", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/zh-TW/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "zh-TW", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/zh-TW", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/zh-TWicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "zh-TW", "@type": "SoftwareApplication", "name": "適用於 WorkBuddy 的 RunAPI Luma", "applicationCategory": "DeveloperApplication", "description": "透過 RunAPI MCP server 在 WorkBuddy 使用 Luma Ray 3.2 修改影片。提示詞驅動的轉換可維持空間一致性，只需一組 API key。", "url": "https://runapi.ai/zh-TW/workbuddy-luma" }, { "@context": "https://schema.org", "inLanguage": "zh-TW", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "Luma 在 WorkBuddy 中可以進行哪些轉換？", "acceptedAnswer": { "@type": "Answer", "text": "Luma modify_video 可透過提示詞驅動的變更重新渲染既有素材 — 氛圍變化（霧、雨、黃金時刻）、風格轉換（電影感、anime、noir）、光線全面調整和環境轉換。它會保留原始攝影機運動與空間配置，WorkBuddy 只需根據自然語言提示詞即可完成操作。" } }, { "@type": "Question", "name": "Luma 與 RunAPI 上其他影片模型有何不同？", "acceptedAnswer": { "@type": "Answer", "text": "Luma 專長於修改既有影片，而非從零生成。其 Ray 3.2 model 可在轉換期間維持 3D 空間一致性，因此物件會保有深度關係，攝影機運動也會維持物理一致。Kling 或 Hailuo 等 model 可從文字或圖片生成新影片 — 全都可透過同一個 runapi MCP server 存取。" } }, { "@type": "Question", "name": "WorkBuddy 會等待結果，還是我必須自行輪詢？", "acceptedAnswer": { "@type": "Answer", "text": "由工作台 agent 處理。Luma task 為非同步 — 工具會回傳 task_id，WorkBuddy 透過 MCP server 輪詢 task，直到狀態為 completed，再將修改後的影片 URL 發布至你的對話中。一般處理時間為 30-120 秒。" } }, { "@type": "Question", "name": "RunAPI 上 Luma 影片修改的費用為何？", "acceptedAnswer": { "@type": "Answer", "text": "Luma 採用固定單次任務計費——每次 modify_video 呼叫收取固定費用，與影片長度無關。請查看 RunAPI 定價頁面了解目前費率。生成失敗不收費。" } }, { "@type": "Question", "name": "我可以在同一個 WorkBuddy 工作階段中，將 Luma 與其他 RunAPI video model 串接嗎？", "acceptedAnswer": { "@type": "Answer", "text": "可以。請 WorkBuddy 使用 Kling 或 Hailuo 生成影片，再將輸出 URL 作為 source_video_url 傳給 Luma modify_video 進行後製處理 — 全程透過同一個 runapi MCP server 與 RUNAPI_API_KEY，在單一對話中完成。" } } ] }, { "@context": "https://schema.org", "inLanguage": "zh-TW", "@type": "HowTo", "name": "如何透過 RunAPI 在 WorkBuddy 使用 Luma", "description": "將 RunAPI 新增為 WorkBuddy 的 MCP server，向工作台 agent 提供來源影片與轉換提示詞，即可取得重新渲染的 Luma Ray 3.2 結果。", "step": [ { "@type": "HowToStep", "position": 1, "name": "新增 RunAPI MCP server", "text": "在 WorkBuddy 中註冊名為 runapi 的 MCP server，指向 https://runapi.ai/mcp，並讓 Authorization header 從 RUNAPI_API_KEY 讀取你的 key。若你已將 RunAPI 連線至 WorkBuddy，同一個 server 已提供 Luma 工具，無須額外設定。", "url": "https://runapi.ai/zh-TW/workbuddy-luma#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "提示工作台 agent", "text": "向 WorkBuddy 提供來源影片 URL，並以自然語言描述轉換內容 — 氛圍、光線、風格或場景編輯。agent 會將你的需求對應至 Luma modify_video 工具，並將 model 設為 luma-modify-video；Luma 會在套用變更時保留原始場景幾何結構。", "url": "https://runapi.ai/zh-TW/workbuddy-luma#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "取得修改後的影片", "text": "Luma task 為非同步。WorkBuddy 會透過 MCP server 輪詢，直到狀態為 completed，接著將重新渲染影片 URL 發布至你的對話中。一般處理時間依複雜度而定，約為 30-120 秒。", "url": "https://runapi.ai/zh-TW/workbuddy-luma#how-step-3" } ] }, { "@context": "https://schema.org", "inLanguage": "zh-TW", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "首頁", "item": "https://runapi.ai/zh-TW" }, { "@type": "ListItem", "position": 2, "name": "適用於 WorkBuddy 的 RunAPI Luma", "item": "https://runapi.ai/zh-TW/workbuddy-luma" } ] } ] ```