Luma API
Luma API 调用基于 Dream Machine 的视频修改和变换。
curl -X POST https://runapi.ai/api/v1/luma/modify_video \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "luma-modify-video",
"video_url": "https://cdn.runapi.ai/public/samples/video.mp4",
"prompt": "将这段办公室行走视频转换为赛博朋克风格,霓虹灯光效,保持原有镜头运动。"
}'
import { LumaClient } from "@runapi.ai/luma";
const client = new LumaClient();
const result = await client.modifyVideo.run({
model: "luma-modify-video",
video_url: "https://cdn.runapi.ai/public/samples/video.mp4",
prompt: "将这段办公室行走视频转换为赛博朋克风格,霓虹灯光效,保持原有镜头运动。",
});
<?php
require __DIR__ . "/vendor/autoload.php";
use RunApi\Luma\LumaClient;
$client = new LumaClient();
$result = $client->modifyVideo->run([
'model' => 'luma-modify-video',
'video_url' => 'https://cdn.runapi.ai/public/samples/video.mp4',
'prompt' => '将这段办公室行走视频转换为赛博朋克风格,霓虹灯光效,保持原有镜头运动。',
]);
require "runapi/luma"
client = RunApi::Luma::Client.new
result = client.modify_video.run(
model: "luma-modify-video",
video_url: "https://cdn.runapi.ai/public/samples/video.mp4",
prompt: "将这段办公室行走视频转换为赛博朋克风格,霓虹灯光效,保持原有镜头运动。"
)
npx skills add runapi-ai/luma -g
# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
# Codex
codex plugin install runapi-mcp@agents
# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursor
Luma Dream Machine 的视频修改模型可对现有素材进行风格重塑、运动调整或场景变换,同时保留原始片段的运动信息和时序结构。
- 多变体覆盖不同速度/质量层级
- Model skill 包含文档、schema 和接入说明
- 适合面向应用的编码工作流
- 失败的生成不计费
定价
技术细节
| 模型 ID | luma-modify-video |
| 提供方 | Luma |
| 模态 | video |
| 任务类型 | asynchronous |
| 计费单位 | call |
| API 端点 | /api/v1/luma/modify_video |
| 商用许可 | 允许商用 |
| 收录状态 | 运行中 |
为应用开发安装 Luma skill
把模型文档、schema、定价说明和接入步骤加载进代码工作区。
# Install the model skill for app development workflows
npx skills add runapi-ai/luma -g
Install the Luma skill for this app: 1. Add runapi-ai/luma with the skills installer. 2. Load SKILL.md in this workspace. 3. Use its docs, schemas, pricing notes, and setup steps when adding model features. 4. Confirm the install path when done.
四步从 model skill 到首次结果
选择模型
根据输出类型、质量要求和延迟目标选择模型与变体。
配置
设置 RunAPI key,并在代码工作区安装对应 model skill。
调用
按 skill 里的说明,把模型能力接入到你的应用里。
接收
按 task ID 轮询、在支持时使用流式,或处理 webhook 回调。
Luma API 是什么?
Luma AI 的 Dream Machine 模型通过重塑视觉风格来修改现有视频,同时保留运动。通过 RunAPI,共享统一 API 和按次计费。
为什么用 RunAPI 调用 Luma API
一把认证,覆盖所有提供方
一把 RunAPI key 解锁整个模型目录。无需为每家提供方单独建账户。
统一的定价与账单
USD 按次定价,按月结算。失败的生成不计费。
Schema 优先的 SDK
Typed schema 和接入说明已打包进 model skill,让实现从正确契约开始。
常见问题
什么是视频修改(modify-video)?
Luma 的 modify-video 端点获取现有视频素材,根据文本提示词重新变换其视觉风格和内容,同时保留原始运动和镜头动态。
它能保留原始运动吗?
能——来自源视频的镜头运动、主体动作和时间结构均会保留,只有视觉风格和外观会发生变化。
我能应用哪些风格?
任何可以用文字描述的风格——电影感、动漫、油画、黑色电影、复古、未来感等。提示词控制变换方向。
支持哪些输入视频格式?
MP4 是主要支持的格式。源素材应在 API 文档指定的大小和时长限制内。
Luma 和 Runway Aleph 有什么区别?
两者都能根据提示词变换现有素材。Luma 专注于通过 Dream Machine 架构进行风格迁移,Runway Aleph 强调逐帧连续性的保留。
应该从哪个变体开始?
选满足质量要求的最便宜变体。多数团队从 fast 起步,生产时升级到 pro。
有免费额度吗?
新账户每个模型都有免费调用额度,之后按次计费。
支持流式吗?
模型支持流式时,RunAPI 端到端流式。
失败怎么计费?
失败的生成不计费。
输出会缓存吗?
输出按任务 ID 存储在 R2 供回取。输入不缓存。
可以商用吗?
可以——所有变体默认含商用许可,除非模型许可明确限制;有例外会在变体页面注明。
速率限制?
Key 级限流随使用层级伸缩。当前限制见定价页。
在哪里报问题?
在公共 GitHub 仓库提 issue 或邮件联系 support。
如果喜欢 Luma API,也可以试试这些
立即体验 Luma API。
- modify_video