Claude 访客：新账户可在 30 天内获得 $1.00 API 赠送额度。每人限领一次，仅用于 API 用量。
在 WorkBuddy 中使用 Luma
Luma Ray 3.2 通过提示词驱动的变换修改现有视频，同时保持空间一致性和 3D 场景结构。WorkBuddy 原生支持 MCP —— 把 RunAPI 添加为 MCP 服务器一次，之后只需把源视频 URL 交给工作台智能体并描述想要的变换。它会调用 Luma 工具，等待异步任务完成，然后返回带有氛围光效和物理一致镜头运动的重渲染视频。
通过 runapi MCP 服务器用 Luma Ray 3.2 修改一段视频。
要求：
- 使用 runapi MCP 服务器的视频修改工具。
- 将 model 设为 "luma-modify-video"。
- 源视频：https://example.com/park-walk.mp4
- 变换要求："把场景变成雾气弥漫的秋日清晨，金色光线透过树林洒下"。
- 任务是异步的 —— 等它完成后把修改好的视频 URL 给我。
{
"mcp_servers": {
"runapi": {
"url": "https://runapi.ai/mcp",
"transport": "streamable_http",
"headers": {
"Authorization": "Bearer $RUNAPI_API_KEY"
}
}
}
}
{
"task_id": "tsk_abc123",
"status": "completed",
"model": "luma-modify-video",
"output": {
"video_url": "https://media.runapi.ai/videos/tsk_abc123.mp4"
}
}
三步在 WorkBuddy 中使用 Luma
添加 RunAPI MCP 服务器
注册一个名为 runapi 的 MCP 服务器，指向 https://runapi.ai/mcp，并在 Authorization 请求头中从 RUNAPI_API_KEY 读取密钥。如果你已经把 RunAPI 接入了 WorkBuddy，同一个服务器就已经暴露了 Luma 工具 —— 无需额外配置。
{
"mcp_servers": {
"runapi": {
"url": "https://runapi.ai/mcp",
"transport": "streamable_http",
"headers": { "Authorization": "Bearer $RUNAPI_API_KEY" }
}
}
}
向工作台智能体发出提示
把源视频 URL 交给 WorkBuddy，并用自然语言描述想要的变换 —— 氛围、光效、风格或场景编辑。智能体会把你的需求映射到 Luma modify_video 工具上（model 设为 luma-modify-video），Luma 在应用更改时会保留原始场景的几何结构。
用 Luma 重塑 https://example.com/park-walk.mp4 的风格：
雾气弥漫的秋日清晨，金色光线透过树林洒下。
接收修改后的视频
Luma 任务是异步的。WorkBuddy 会通过 MCP 服务器轮询任务，直到状态为 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 服务器调用它，与工作台里其他所有模型共用同一个服务器和 RUNAPI_API_KEY。
Luma 使用场景
氛围短片与音乐视频美学
让 WorkBuddy 用 Luma 的梦幻视觉质感将原始素材转化为风格化氛围短片。在保留原始运动的同时改变光效、氛围和色调，用于音乐视频概念或艺术项目。
广告方向的视觉快速假设验证
在同一个工作台对话里，将现有产品视频以多个视觉方向重新渲染 —— 电影感、极简风、黑色电影或季节性风格 —— 在确定全面重拍前测试哪种风格最有效。
多工具流水线的基础素材
使用 Luma 对生成或拍摄的素材进行风格化处理，再让 WorkBuddy 在同一会话中把结果传给其他 RunAPI 工具。Luma 的高速交付使其在更大型视频流水线中作为风格化步骤切实可行。
Luma + WorkBuddy 常见问题
Luma modify_video 以提示词驱动的更改重新渲染现有素材 —— 氛围转换（雾、雨、黄金时刻）、风格迁移（电影感、动漫、黑色电影）、光照重塑以及环境变换。它会保留场景原有的镜头运动和空间布局，而这一切在 WorkBuddy 里只需一句自然语言提示即可完成。
Luma 专注于修改现有视频，而非从零生成。其 Ray 3.2 模型在变换过程中保持 3D 空间一致性，因此物体保留其深度关系，镜头运动保持物理一致。而像 Kling 或 Hailuo 这样的模型则是从文本或图像生成新视频 —— 它们都可以通过同一个 runapi MCP 服务器调用。
工作台智能体会处理好这一切。Luma 任务是异步的 —— 工具先返回一个 task_id，WorkBuddy 通过 MCP 服务器轮询任务直到状态为 completed，然后把修改后的视频 URL 发到你的对话中。典型处理时间为 30-120 秒。
Luma 采用按任务统一计费 —— 每次 modify_video 调用收取固定金额，与视频长度无关。当前费率请查看 RunAPI 定价页面。生成失败不收费。
可以。让 WorkBuddy 先用 Kling 或 Hailuo 生成视频，再将输出 URL 作为 source_video_url 传给 Luma modify_video 进行后处理 —— 全部通过同一个 runapi MCP 服务器和 RUNAPI_API_KEY，在一个对话里完成。
立即在 WorkBuddy 中试用 Luma。
免费获取 RunAPI 密钥，在 WorkBuddy 中添加 MCP 服务器，不离开工作台即可使用 Luma Ray 3.2 的空间感知变换修改视频。