在 Hermes Agent 中使用 Luma。
Luma Ray 3.2 通过提示词驱动的变换修改现有视频，同时保持空间一致性和 3D 场景结构。发送源视频 URL 和描述变换的文本提示词——Luma 会以富有氛围的光照、环境细节以及物理一致的镜头运动重新渲染素材。Hermes Agent 通过 RunAPI 自定义端点调用它。
使用 RunAPI 通过 Luma Ray 3.2 修改视频。
要求：
- 从 RUNAPI_API_KEY 读取 API 密钥。
- 使用 custom:runapi 提供商，base_url 为 https://runapi.ai/v1。
- 调用 POST https://runapi.ai/api/v1/luma/modify_video
- 将 model 设为 "luma-modify-video"。
- 将 source_video_url 设为要变换的视频的 URL。
- 将 prompt 设为描述所需变换的内容。
- 该任务为异步任务。轮询返回的 task_id 直到 status 为 "completed"。
- 完成后，从响应 output 中读取修改后的视频 URL。
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
Configure RunAPI
Set RUNAPI_API_KEY in the environment where Hermes Agent runs. If you already added RunAPI as a custom:runapi provider, the same key handles Luma video modification requests.
export RUNAPI_API_KEY=runapi_xxx
Call Luma modify_video
Send a POST request to the modify_video endpoint with model set to luma-modify-video, the source_video_url pointing to your input footage, and a prompt describing the transformation. Hermes Agent can build and send this request through the custom:runapi provider.
POST /api/v1/luma/modify_video
Poll for the result
The endpoint returns a task_id immediately. Poll the task status endpoint until the status is completed, then read the output video URL from the response. Video modification typically takes 30-120 seconds depending on complexity.
GET /api/v1/luma/modify_video/tsk_abc123
Luma modify_video API 参数
| 参数 | 类型 | 说明 |
|---|---|---|
model |
string |
Required. Use luma-modify-video. |
prompt |
string |
Required. Text description of the desired video transformation — style changes, lighting, atmosphere, or scene edits. |
source_video_url |
string |
Required. URL of the source video to modify. Must be a publicly accessible MP4 or MOV file. |
watermark |
boolean |
Optional. Whether to add a watermark to the output video. |
callback_url |
string |
Optional. Webhook URL that receives a POST when the task completes. |
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 re-renders existing footage with prompt-driven changes — atmospheric shifts (fog, rain, golden hour), style transfers (cinematic, anime, noir), lighting overhauls, and environmental transformations. It preserves the original camera motion and spatial layout of the scene.
No. Luma Ray 3.2 only modifies the visual track of your source video. If the source has audio, Luma's output is video-only. Use a separate audio model like ElevenLabs or Suno through RunAPI to add sound after the visual transformation is complete.
Asynchronous. The create endpoint returns a task_id immediately. Poll the task status endpoint or provide a callback_url to receive a webhook when the modified video is ready. Typical processing time is 30-120 seconds.
Yes. A Hermes Agent workflow can generate a video with Kling or Wan, then pass the output URL as source_video_url to Luma modify_video for atmospheric re-rendering — all through the same custom:runapi provider and RUNAPI_API_KEY. Each step uses the same async polling pattern.
Luma preserves the original composition and spatial layout, including character positions and proportions. However, fine facial details can drift during heavy style transfers. For best character consistency, keep style changes moderate or use reference images to anchor key subjects.
Yes. Hermes Agent can chain Luma calls -- apply a style change first, then a scene modification, each building on the previous output. This enables complex multi-pass video editing within one workflow.
立即在 Hermes Agent 中试用 Luma。
免费获取 RunAPI 密钥，配置 custom:runapi 提供商，开始使用 Luma Ray 3.2 的空间感知变换修改视频。