--- title: 透過 RunAPI 在 WorkBuddy 使用 Luma — 影片 MCP 指南 | RunAPI description: 透過 RunAPI MCP server 在 WorkBuddy 中以 Luma Ray 3.2 修改影片。以提示詞驅動轉換並保持空間一致性，只需一個 API 金鑰。 url: https://runapi.ai/zh-HK/workbuddy-luma.md canonical: https://runapi.ai/zh-HK/workbuddy-luma locale: zh-HK 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-HK/workbuddy-luma > Site index for agents: https://runapi.ai/llms.txt # 在 WorkBuddy 中使用 Luma。 Luma Ray 3.2 透過提示詞驅動的轉換修改現有影片，同時保留空間一致性與 3D 場景結構。WorkBuddy 原生支援 MCP — 只需將 RunAPI 加入為 MCP server 一次，然後向工作台 agent 提供來源影片 URL 並描述轉換效果。它會呼叫 Luma 工具、等待非同步任務完成，並回傳具有大氣光效及物理一致鏡頭運動的重新渲染影片。 - [取得 API Key](https://runapi.ai/zh-HK/login) - [閱讀文件](https://runapi.ai/zh-HK/docs/guides) 一個 MCP server · 一個 RunAPI 金鑰 · 非同步任務處理 ### 提示詞 ```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 伺服器** - 將 RunAPI 註冊為名為 runapi 的 MCP server，指向 https://runapi.ai/mcp，並在 Authorization 標頭中從 RUNAPI_API_KEY 讀取金鑰。若已將 RunAPI 連接至 WorkBuddy，同一個 server 即已提供 Luma 工具，無需額外設定。 `{ "mcp_servers": { "runapi": { "url": "https://runapi.ai/mcp", "transport": "streamable_http", "headers": { "Authorization": "Bearer $RUNAPI_API_KEY" } } } } ` 2. **提示工作台代理** - 向 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 任務為非同步。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` | 選填。任務完成時接收 POST 請求的 Webhook URL。 | | `task_id` | `string` | 由工具回傳。WorkBuddy 用此輪詢非同步任務，直至修改後的影片就緒。 | ## 什麼是 WorkBuddy 上的 Luma？ Luma Ray 3.2（Dream Machine）專門修改現有影片，具備用戶形容為電影感強且易於迭代的夢幻風格。它並非從頭生成，而是以提示詞驅動的轉換重新渲染來源影片 — 包括氛圍轉換、風格轉換及環境變化 — 同時保持原始空間佈局與鏡頭運動不變。WorkBuddy 透過 runapi MCP server 呼叫它，與工作台中所有其他模型共用同一個 server 及 RUNAPI_API_KEY。 ## Luma 使用場景 - **氛圍作品及音樂視頻美學** - 使用 Luma 的夢幻視覺風格，讓 WorkBuddy 將原始片段轉化為風格化的情緒片段。在保留原始動態的同時調整光效、氛圍與色調，適合音樂影片概念或藝術創作。 - **廣告方向的快速視覺假設** - 在單一工作台對話中，將現有產品影片以多種視覺方向重新風格化 — 電影感、簡約、黑色電影或季節風格 — 在決定全面重拍前先測試哪種效果最佳。 - **多工具流水線的基礎素材** - 使用 Luma 重新風格化生成或拍攝的素材，然後讓 WorkBuddy 在同一個 session 中將結果傳遞至其他 RunAPI 工具。Luma 的快速處理使其可作為大型影片流程中的風格化步驟。 ## Luma + WorkBuddy 常見問題 ### Luma 在 WorkBuddy 中能進行哪些類型的轉換？ Luma modify_video 以提示詞驅動的變更重新渲染現有素材 — 氛圍轉換（霧、雨、黃金時段）、風格轉換（電影感、動漫、黑色電影）、光效調整及環境變化。它保留原始鏡頭運動與空間佈局，WorkBuddy 透過自然語言提示詞驅動整個過程。 ### Luma 與 RunAPI 上其他視頻模型有何不同？ Luma 專注於修改現有影片而非從頭生成。其 Ray 3.2 模型在轉換期間保持 3D 空間一致性，使物件保持其深度關係，鏡頭運動亦維持物理一致性。Kling 或 Hailuo 等模型則從文字或圖像生成全新影片 — 均可透過同一個 runapi MCP server 呼叫。 ### WorkBuddy 會等待結果，還是需要我自行輪詢？ 由工作台 agent 負責處理。Luma 任務為非同步 — 工具回傳 task_id 後，WorkBuddy 透過 MCP server 輪詢任務直至狀態顯示為 completed，然後將修改後的影片 URL 發佈至您的對話中。一般處理時間約為 30-120 秒。 ### 在 RunAPI 上使用 Luma 視頻修改需要多少費用？ Luma 採用固定按任務計費——每次 modify_video 呼叫收取固定金額，與視頻長度無關。請查看 RunAPI 定價頁面了解最新收費。生成失敗不會收費。 ### 我可以在一個 WorkBuddy session 中將 Luma 與其他 RunAPI 影片模型串聯使用嗎？ 可以。讓 WorkBuddy 使用 Kling 或 Hailuo 生成影片，然後將輸出 URL 作為 source_video_url 傳遞給 Luma modify_video 進行後期處理 — 全程透過同一個 runapi MCP server 及 RUNAPI_API_KEY，在單一對話中完成。 - [WorkBuddy 設定指南 →](https://runapi.ai/zh-HK/workbuddy.md) - 尚未連接？請先參閱 WorkBuddy 的 RunAPI MCP 設定指南。 - [Luma on RunAPI →](https://runapi.ai/zh-HK/models/luma.md) - 查看 Luma 變體、定價及 API 文件。 ## 立即在 WorkBuddy 中試用 Luma。 獲取免費 RunAPI 金鑰，將 MCP server 加入 WorkBuddy，即可在工作台內使用 Luma Ray 3.2 的空間感知轉換功能修改影片。 [瀏覽模型 →](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 Luma", "applicationCategory": "DeveloperApplication", "description": "透過 RunAPI MCP server 在 WorkBuddy 中以 Luma Ray 3.2 修改影片。以提示詞驅動轉換並保持空間一致性，只需一個 API 金鑰。", "url": "https://runapi.ai/zh-HK/workbuddy-luma" }, { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "Luma 在 WorkBuddy 中能進行哪些類型的轉換？", "acceptedAnswer": { "@type": "Answer", "text": "Luma modify_video 以提示詞驅動的變更重新渲染現有素材 — 氛圍轉換（霧、雨、黃金時段）、風格轉換（電影感、動漫、黑色電影）、光效調整及環境變化。它保留原始鏡頭運動與空間佈局，WorkBuddy 透過自然語言提示詞驅動整個過程。" } }, { "@type": "Question", "name": "Luma 與 RunAPI 上其他視頻模型有何不同？", "acceptedAnswer": { "@type": "Answer", "text": "Luma 專注於修改現有影片而非從頭生成。其 Ray 3.2 模型在轉換期間保持 3D 空間一致性，使物件保持其深度關係，鏡頭運動亦維持物理一致性。Kling 或 Hailuo 等模型則從文字或圖像生成全新影片 — 均可透過同一個 runapi MCP server 呼叫。" } }, { "@type": "Question", "name": "WorkBuddy 會等待結果，還是需要我自行輪詢？", "acceptedAnswer": { "@type": "Answer", "text": "由工作台 agent 負責處理。Luma 任務為非同步 — 工具回傳 task_id 後，WorkBuddy 透過 MCP server 輪詢任務直至狀態顯示為 completed，然後將修改後的影片 URL 發佈至您的對話中。一般處理時間約為 30-120 秒。" } }, { "@type": "Question", "name": "在 RunAPI 上使用 Luma 視頻修改需要多少費用？", "acceptedAnswer": { "@type": "Answer", "text": "Luma 採用固定按任務計費——每次 modify_video 呼叫收取固定金額，與視頻長度無關。請查看 RunAPI 定價頁面了解最新收費。生成失敗不會收費。" } }, { "@type": "Question", "name": "我可以在一個 WorkBuddy session 中將 Luma 與其他 RunAPI 影片模型串聯使用嗎？", "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-HK", "@type": "HowTo", "name": "如何透過 RunAPI 在 WorkBuddy 中使用 Luma", "description": "在 WorkBuddy 中將 RunAPI 加入為 MCP server，向工作台 agent 提供來源影片與轉換提示詞，即可收到 Luma Ray 3.2 重新渲染的結果。", "step": [ { "@type": "HowToStep", "position": 1, "name": "新增 RunAPI MCP 伺服器", "text": "將 RunAPI 註冊為名為 runapi 的 MCP server，指向 https://runapi.ai/mcp，並在 Authorization 標頭中從 RUNAPI_API_KEY 讀取金鑰。若已將 RunAPI 連接至 WorkBuddy，同一個 server 即已提供 Luma 工具，無需額外設定。", "url": "https://runapi.ai/zh-HK/workbuddy-luma#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "提示工作台代理", "text": "向 WorkBuddy 提供來源影片 URL，並以自然語言描述轉換效果 — 氛圍、光效、風格或場景編輯。Agent 會將您的請求對應至 Luma modify_video 工具，並將 model 設為 luma-modify-video，Luma 在套用變更的同時保留原始場景幾何結構。", "url": "https://runapi.ai/zh-HK/workbuddy-luma#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "接收修改後的影片", "text": "Luma 任務為非同步。WorkBuddy 透過 MCP server 輪詢任務，直至狀態顯示為 completed，然後將重新渲染的影片 URL 發佈至您的對話中。一般處理時間視複雜度而定，約需 30-120 秒。", "url": "https://runapi.ai/zh-HK/workbuddy-luma#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 Luma", "item": "https://runapi.ai/zh-HK/workbuddy-luma" } ] } ] ```