Luma API
Dream Machine으로 구동되는 비디오 수정 및 변환을 위한 Luma API 액세스.
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의 비디오 수정 모델은 소스 클립의 모션과 시간 구조를 보존하면서 새로운 시각적 스타일이나 장면 변경으로 기존 영상을 재변환합니다.
- 품질과 지연 시간 목표에 맞춘 모델 변형
- 통합 API key
- Model skill에 docs, schema, 설정 메모 포함
- 실패한 생성은 과금되지 않습니다
요금
스펙
| 모델 ID | luma-modify-video |
| 제공사 | Luma |
| 모달리티 | video |
| 작업 유형 | asynchronous |
| 과금 | call |
| Endpoint | /api/v1/luma/modify_video |
| 상업적 사용 | 예 |
| 카탈로그 상태 | 운영 중 |
앱 개발을 위해 Luma skill 설치
모델 docs, 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를 사용합니다.
skill 설치
기능을 구현하기 전에 코딩 워크스페이스에 model skill을 추가합니다.
결과 받기
task ID로 조회하거나 생성 완료 시 callback을 처리합니다.
Luma의 위치
Luma AI의 Dream Machine 모델은 모션을 보존하면서 시각적 스타일을 재변환하여 기존 비디오를 수정합니다. RunAPI를 통해 통합 API 액세스와 호출별 과금 방식을 공유합니다.
RunAPI로 Luma을 쓰는 이유
하나의 API key
모델과 제공사를 넘나들며 같은 인증 정보를 사용합니다.
Skill-ready
model skill에 schema, 설정 메모, 가격 컨텍스트, 모델 ID가 포함됩니다.
예측 가능한 과금
호출 전에 사용량 기반 가격을 확인할 수 있습니다.
자주 묻는 질문
비디오 수정이란 무엇인가요?
Luma의 modify-video 엔드포인트는 기존 영상을 받아 원본 모션과 카메라 역학을 보존하면서 텍스트 프롬프트에 따라 시각적 스타일과 내용을 재변환합니다.
원본 모션이 보존되나요?
네 — 카메라 움직임, 피사체 모션, 소스 비디오의 시간 구조가 유지됩니다. 시각적 스타일과 외형만 변경됩니다.
어떤 스타일을 적용할 수 있나요?
텍스트로 설명 가능한 모든 스타일 — 시네마틱, 애니메이션, 회화적, 누아르, 레트로, 미래적 등. 프롬프트가 변환 방향을 제어합니다.
어떤 입력 비디오 형식이 지원되나요?
MP4가 주요 지원 형식입니다. API 문서에 명시된 크기 및 지속 시간 제한 내에서 소스 클립을 유지하세요.
Luma는 Runway Aleph와 어떻게 비교되나요?
두 모델 모두 프롬프트로 기존 영상을 변환합니다. Luma는 Dream Machine 아키텍처를 통한 스타일 전환에 중점을 둡니다. Runway Aleph는 프레임 수준의 연속성 보존을 강조합니다.
이 모델은 어떻게 호출하나요?
model skill을 설치하고 RunAPI key와 함께 설정 메모를 따르세요.
실패한 생성도 비용이 드나요?
실패한 생성은 과금되지 않습니다
애플리케이션에서 호출할 수 있나요?
네. 코딩 워크스페이스에 model skill을 설치하고 모델 기능을 추가할 때 사용하세요.