在 OpenClaw 中使用 Luma。
Luma Ray 3.2 透過提示詞驅動的轉換修改現有影片，保留空間一致性與 3D 場景結構。傳送來源影片 URL 和描述轉換效果的文字提示詞，Luma 會重新渲染畫面，帶有氛圍光影、環境細節和物理一致的攝影機運動。OpenClaw agent 使用與聊天相同的 RunAPI key 來呼叫。
Use RunAPI to modify a video with Luma Ray 3.2.
Requirements:
- Read the API key from RUNAPI_API_KEY.
- Call POST https://runapi.ai/api/v1/luma/modify_video
- Set model to "luma-modify-video".
- Set source_video_url to the URL of the video to transform.
- Set prompt to describe the desired transformation.
- The task is async. Poll the returned task_id until status is "completed".
- When done, read the modified video URL from the response output.
curl -X POST https://runapi.ai/api/v1/luma/modify_video \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "luma-modify-video",
"prompt": "Transform the scene into a foggy autumn morning with golden light filtering through trees",
"source_video_url": "https://example.com/park-walk.mp4"
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "luma-modify-video"
}
三步驟在 OpenClaw 中使用 Luma
設定 RunAPI
在環境中設定 RUNAPI_API_KEY。如果你已在 OpenClaw 中設定 RunAPI 用於聊天，同一組 key 即可用於 Luma 影片修改，無需額外的 provider 設定。
export RUNAPI_API_KEY=runapi_xxx
呼叫 Luma modify_video
向 modify_video 端點發送 POST 請求，將 model 設為 luma-modify-video，source_video_url 指向你的輸入影片，並以 prompt 描述轉換效果。Luma 會保留原始場景幾何結構，同時套用所要求的變更。
POST /api/v1/luma/modify_video
輪詢結果
端點會立即回傳 task_id。輪詢任務狀態端點，直到 status 為 completed，然後從回應中讀取輸出影片 URL。影片修改通常需要 30-120 秒，取決於複雜度。
GET /api/v1/luma/modify_video/tsk_abc123
Luma modify_video API 參數
| 參數 | 類型 | 說明 |
|---|---|---|
model |
string |
必填。使用 luma-modify-video。 |
prompt |
string |
必填。描述所需影片轉換的文字說明 — 風格變化、光影、氛圍或場景編輯。 |
source_video_url |
string |
必填。要修改的來源影片 URL。必須是可公開存取的 MP4 或 MOV 檔案。 |
watermark |
boolean |
選填。是否在輸出影片上加入浮水印。 |
callback_url |
string |
選填。任務完成時接收 POST 通知的 Webhook URL。 |
OpenClaw 上的 Luma 是什麼？
Luma Ray 3.2（Dream Machine）專門以使用者描述為「電影感、迭代速度快」的夢幻品質修改現有影片。它不從零開始生成，而是用提示詞驅動的轉換——大氣調整、風格轉換和環境更改——重新渲染來源影片，同時保持原始的空間佈局和攝影機動作。OpenClaw 代理透過 RunAPI，使用與聊天相同的 API key 呼叫它。
Luma 使用情境
氛圍短片與音樂影片美學
用 Luma 的夢幻視覺品質將原始素材轉化為風格化的氛圍短片。在保留原始動態的前提下，改變光線、氛圍和色調，用於音樂影片概念或藝術專案。
廣告方向的快速視覺假設
以多種視覺方向——電影感、簡約、黑色電影風或季節感——重新風格化現有商品影片，在決定完整重拍前測試哪種風格最有效。
多工具流程的基礎素材
使用 Luma 重新風格化生成或拍攝的素材，再傳遞給其他工具進行最終剪輯。Luma 快速的生成速度使其成為更大型影片流程中風格化步驟的實用選擇。
Luma + OpenClaw 常見問題
Luma modify_video 透過提示詞驅動的變更重新渲染現有影片 — 氛圍轉換（霧、雨、黃金時刻）、風格轉移（電影感、動漫、黑色電影）、光影大改和環境轉換。它會保留原始的攝影機運動和場景空間佈局。
Luma 專精於修改現有影片，而非從零生成。其 Ray 3.2 模型在轉換過程中維持 3D 空間一致性，使物件保持深度關係，攝影機運動保持物理一致。Kling 或 Hailuo 等模型則是從文字或圖片生成新影片。
非同步。建立端點會立即回傳 task_id。輪詢任務狀態端點或提供 callback_url 以在修改後的影片準備就緒時接收 webhook。一般處理時間為 30-120 秒。
Luma 使用每任務固定計費 — 每次 modify_video 呼叫的費用固定，與影片長度無關。請查看 RunAPI 定價頁面了解目前費率。失敗的生成不會收費。
可以。OpenClaw agent 可以先用 Kling 或 Hailuo 生成影片，再將輸出 URL 作為 source_video_url 傳給 Luma modify_video 進行後製 — 全部透過同一個 RUNAPI_API_KEY。每個步驟使用相同的非同步輪詢模式。