在 Hermes Agent 中使用 Luma。
Luma Ray 3.2 透過提示詞驅動的轉換修改現有影片，保留空間一致性與 3D 場景結構。傳送來源影片 URL 和描述轉換效果的文字提示詞，Luma 會重新渲染畫面，帶有氛圍光影、環境細節和物理一致的攝影機運動。Hermes Agent 透過 RunAPI custom 端點來呼叫。
Use RunAPI to modify a video with Luma Ray 3.2.
Requirements:
- Read the API key from RUNAPI_API_KEY.
- Use the custom:runapi provider with base_url https://runapi.ai/v1.
- 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"
}
三步驟在 Hermes Agent 中使用 Luma
設定 RunAPI
在 Hermes Agent 執行環境中設定 RUNAPI_API_KEY。如果你已將 RunAPI 新增為 custom:runapi provider，同一組 key 即可處理 Luma 影片修改請求。
export RUNAPI_API_KEY=runapi_xxx
呼叫 Luma modify_video
向 modify_video 端點發送 POST 請求，將 model 設為 luma-modify-video，source_video_url 指向你的輸入影片，並以 prompt 描述轉換效果。Hermes Agent 可透過 custom:runapi provider 建構並發送此請求。
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。 |
Hermes Agent 上的 Luma 是什麼？
Luma Ray 3.2（Dream Machine）以提示詞驅動的變換重新渲染現有影片，同時保持 3D 空間一致性和物理上連貫的鏡頭運動。通過 Hermes Agent 的 custom:runapi provider，它可處理源素材上的大氣調整、風格遷移和環境編輯。
Luma 使用場景
概念宣傳片與動態靜幀
將靜態概念圖或粗剪素材變換為風格化動態作品。Hermes Agent 可在單一工作流中先用 Kling 或 Wan 生成基礎影片，再傳給 Luma 進行大氣感重新渲染。
季節性與品牌內容再利用
將現有影片素材重新渲染為季節性活動、新品牌規範或不同市場風格，無需重新拍攝。Luma 在改變視覺處理的同時保留原始構圖。
抽象與超現實視覺內容
對源素材施加超現實、繪畫感或抽象變換，用於創意項目、音樂可視化或實驗性內容，充分發揮 Luma 夢幻渲染質感的優勢。
Luma + Hermes Agent 常見問題
Luma modify_video 透過提示詞驅動的變更重新渲染現有影片 — 氛圍轉換（霧、雨、黃金時刻）、風格轉移（電影感、動漫、黑色電影）、光影大改和環境轉換。它會保留原始的攝影機運動和場景空間佈局。
在 Hermes Agent 設定中新增名為 runapi 的 custom provider，將 base_url 設為 https://runapi.ai/v1，key_env 設為 RUNAPI_API_KEY。設定完成後，同一個 provider 即可處理 Luma modify_video 呼叫以及聊天和其他 RunAPI 模型請求。
非同步。建立端點會立即回傳 task_id。輪詢任務狀態端點或提供 callback_url 以在修改後的影片準備就緒時接收 webhook。一般處理時間為 30-120 秒。
Luma 使用每任務固定計費 — 每次 modify_video 呼叫的費用固定，與影片長度無關。請查看 RunAPI 定價頁面了解目前費率。失敗的生成不會收費。
可以。Hermes Agent 工作流程可以先用 Kling 或 Wan 生成影片，再將輸出 URL 作為 source_video_url 傳給 Luma modify_video 進行氛圍重新渲染 — 全部透過同一個 custom:runapi provider 和 RUNAPI_API_KEY。每個步驟使用相同的非同步輪詢模式。
立即在 Hermes Agent 中試用 Luma。
取得免費 RunAPI key，設定 custom:runapi provider，即可使用 Luma Ray 3.2 的空間感知轉換開始修改影片。