Hermes Agent에서 Luma를 사용하세요.
Luma Ray 3.2는 공간적 일관성과 3D 장면 구조를 보존하는 프롬프트 기반 변환으로 기존 영상을 수정합니다. 소스 영상 URL과 변환을 설명하는 텍스트 프롬프트를 전송하면 — Luma가 대기 조명, 환경 세부 사항, 물리적으로 일관된 카메라 모션으로 영상을 재렌더링합니다. Hermes Agent는 RunAPI 커스텀 엔드포인트를 통해 호출합니다.
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"
}
Hermes Agent에서 Luma를 세 단계로 사용하기
RunAPI 설정
Hermes Agent가 실행되는 환경에 RUNAPI_API_KEY를 설정하세요. RunAPI를 custom:runapi 프로바이더로 이미 추가했다면, 동일한 key로 Luma 영상 변환 요청을 처리합니다.
export RUNAPI_API_KEY=runapi_xxx
Luma modify_video 호출
modify_video 엔드포인트에 model을 luma-modify-video로 설정하고, source_video_url을 입력 영상으로 지정하고, 변환 내용을 설명하는 프롬프트와 함께 POST 요청을 보내세요. Hermes Agent는 custom:runapi 프로바이더를 통해 이 요청을 빌드하고 전송할 수 있습니다.
POST /api/v1/luma/modify_video
결과 가져오기
엔드포인트는 즉시 task_id를 반환합니다. 상태가 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를 수신하는 웹훅 URL. |
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는 프롬프트 기반 변경으로 기존 영상을 재렌더링합니다 — 분위기 변화(안개, 비, 골든 아워), 스타일 전환(시네마틱, 애니메이션, 누아르), 조명 개편, 환경 변환. 원본 카메라 모션과 장면의 공간적 레이아웃을 보존합니다.
Hermes Agent 설정에 base_url https://runapi.ai/v1과 key_env RUNAPI_API_KEY를 사용하여 runapi라는 커스텀 프로바이더를 추가하세요. 설정이 완료되면 동일한 프로바이더가 채팅 및 다른 RunAPI 모델 요청과 함께 Luma modify_video 호출을 처리합니다.
비동기식입니다. 생성 엔드포인트는 즉시 task_id를 반환합니다. 변환된 영상이 준비되면 웹훅을 수신하려면 작업 상태 엔드포인트를 폴링하거나 callback_url을 제공하세요. 일반적인 처리 시간은 30~120초입니다.
Luma는 작업당 고정 청구를 사용합니다 — 각 modify_video 호출은 영상 길이에 관계없이 고정 금액이 청구됩니다. 현재 요금은 RunAPI 가격 페이지를 확인하세요. 실패한 생성은 청구되지 않습니다.
네. Hermes Agent 워크플로우는 Kling이나 Wan으로 영상을 생성한 후, 출력 URL을 Luma modify_video의 source_video_url로 전달하여 분위기 재렌더링을 할 수 있습니다 — 모두 동일한 custom:runapi 프로바이더와 RUNAPI_API_KEY를 통해. 각 단계는 동일한 비동기 폴링 패턴을 사용합니다.
지금 Hermes Agent에서 Luma를 사용해보세요.
무료 RunAPI key를 발급받고, custom:runapi 프로바이더를 설정하여 Luma Ray 3.2의 공간 인식 변환으로 영상 수정을 시작하세요.