Luma modify_video 可以做什麼樣的轉換？

Luma modify_video 透過提示詞驅動的變更重新渲染現有影片 — 氛圍轉換（霧、雨、黃金時刻）、風格轉移（電影感、動漫、黑色電影）、光影大改和環境轉換。它會保留原始的攝影機運動和場景空間佈局。

如何在 Hermes Agent 中設定 custom:runapi provider 來使用 Luma？

在 Hermes Agent 設定中新增名為 runapi 的 custom provider，將 base_url 設為 https://runapi.ai/v1，key_env 設為 RUNAPI_API_KEY。設定完成後，同一個 provider 即可處理 Luma modify_video 呼叫以及聊天和其他 RunAPI 模型請求。

Luma modify_video 是同步還是非同步的？

非同步。建立端點會立即回傳 task_id。輪詢任務狀態端點或提供 callback_url 以在修改後的影片準備就緒時接收 webhook。一般處理時間為 30-120 秒。

在 RunAPI 上使用 Luma 影片修改的費用是多少？

Luma 使用每任務固定計費 — 每次 modify_video 呼叫的費用固定，與影片長度無關。請查看 RunAPI 定價頁面了解目前費率。失敗的生成不會收費。

Hermes Agent 可以在一個工作流程中將 Luma 與影片生成模型串接嗎？

可以。Hermes Agent 工作流程可以先用 Kling 或 Wan 生成影片，再將輸出 URL 作為 source_video_url 傳給 Luma modify_video 進行氛圍重新渲染 — 全部透過同一個 custom:runapi provider 和 RUNAPI_API_KEY。每個步驟使用相同的非同步輪詢模式。

HERMES + LUMA

在 Hermes Agent 中使用 Luma。

Luma Ray 3.2 透過提示詞驅動的轉換修改現有影片，保留空間一致性與 3D 場景結構。傳送來源影片 URL 和描述轉換效果的文字提示詞，Luma 會重新渲染畫面，帶有氛圍光影、環境細節和物理一致的攝影機運動。Hermes Agent 透過 RunAPI custom 端點來呼叫。

取得 API Key 閱讀說明文件

一個 API key · 修改影片端點 · 非同步任務輪詢

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"
}

複製 curl 指令進行測試 luma

運作原理

三步驟在 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，可對來源影片進行大氣調整、風格轉換和環境編輯。使用者看重其電影感效果和快速、無障礙的迭代循環。