---
title: "Hermes Agent에서 RunAPI로 Luma 사용하기 — 영상 변환 API"
url: "https://runapi.ai/ko/hermes-luma.md"
canonical: "https://runapi.ai/ko/hermes-luma"
locale: "ko"
model: "luma"
---

# Hermes Agent에서 Luma를 사용하세요.

Luma Ray 3.2는 공간적 일관성과 3D 장면 구조를 보존하는 프롬프트 기반 변환으로 기존 영상을 수정합니다. 소스 영상 URL과 변환을 설명하는 텍스트 프롬프트를 전송하면 — Luma가 대기 조명, 환경 세부 사항, 물리적으로 일관된 카메라 모션으로 영상을 재렌더링합니다. Hermes Agent는 RunAPI 커스텀 엔드포인트를 통해 호출합니다.

## API example

```bash
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"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "luma-modify-video"
}

```

## How it works

1. **RunAPI 설정** — Hermes Agent가 실행되는 환경에 RUNAPI_API_KEY를 설정하세요. RunAPI를 custom:runapi 프로바이더로 이미 추가했다면, 동일한 key로 Luma 영상 변환 요청을 처리합니다.
2. **Luma modify_video 호출** — modify_video 엔드포인트에 model을 luma-modify-video로 설정하고, source_video_url을 입력 영상으로 지정하고, 변환 내용을 설명하는 프롬프트와 함께 POST 요청을 보내세요. Hermes Agent는 custom:runapi 프로바이더를 통해 이 요청을 빌드하고 전송할 수 있습니다.
3. **결과 가져오기** — 엔드포인트는 즉시 task_id를 반환합니다. 상태가 completed가 될 때까지 작업 상태 엔드포인트를 폴링한 후 응답에서 출력 영상 URL을 읽으세요. 영상 변환은 복잡도에 따라 일반적으로 30~120초가 소요됩니다.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | 필수. luma-modify-video를 사용하세요. |
| `prompt` | `string` | 필수. 원하는 영상 변환의 텍스트 설명 — 스타일 변경, 조명, 분위기, 또는 장면 편집. |
| `source_video_url` | `string` | 필수. 변환할 소스 영상의 URL. 공개 접근 가능한 MP4 또는 MOV 파일이어야 합니다. |
| `watermark` | `boolean` | 선택 사항. 출력 영상에 워터마크를 추가할지 여부. |
| `callback_url` | `string` | 선택 사항. 작업 완료 시 POST를 수신하는 웹훅 URL. |

## FAQ

### Luma modify_video는 어떤 종류의 변환을 할 수 있나요?

Luma modify_video는 프롬프트 기반 변경으로 기존 영상을 재렌더링합니다 — 분위기 변화(안개, 비, 골든 아워), 스타일 전환(시네마틱, 애니메이션, 누아르), 조명 개편, 환경 변환. 원본 카메라 모션과 장면의 공간적 레이아웃을 보존합니다.

### Hermes Agent에서 Luma용 custom:runapi 프로바이더를 어떻게 설정하나요?

Hermes Agent 설정에 base_url https://runapi.ai/v1과 key_env RUNAPI_API_KEY를 사용하여 runapi라는 커스텀 프로바이더를 추가하세요. 설정이 완료되면 동일한 프로바이더가 채팅 및 다른 RunAPI 모델 요청과 함께 Luma modify_video 호출을 처리합니다.

### Luma modify_video는 동기식인가요, 비동기식인가요?

비동기식입니다. 생성 엔드포인트는 즉시 task_id를 반환합니다. 변환된 영상이 준비되면 웹훅을 수신하려면 작업 상태 엔드포인트를 폴링하거나 callback_url을 제공하세요. 일반적인 처리 시간은 30~120초입니다.

### RunAPI에서 Luma 영상 변환 비용은 얼마인가요?

Luma는 작업당 고정 청구를 사용합니다 — 각 modify_video 호출은 영상 길이에 관계없이 고정 금액이 청구됩니다. 현재 요금은 RunAPI 가격 페이지를 확인하세요. 실패한 생성은 청구되지 않습니다.

### Hermes Agent가 하나의 워크플로우에서 Luma를 영상 생성 모델과 연결할 수 있나요?

네. Hermes Agent 워크플로우는 Kling이나 Wan으로 영상을 생성한 후, 출력 URL을 Luma modify_video의 source_video_url로 전달하여 분위기 재렌더링을 할 수 있습니다 — 모두 동일한 custom:runapi 프로바이더와 RUNAPI_API_KEY를 통해. 각 단계는 동일한 비동기 폴링 패턴을 사용합니다.


## Links

- [Hermes Agent 설정 가이드 →](https://runapi.ai/ko/hermes-agent)
- [RunAPI의 Luma →](https://runapi.ai/ko/models/luma)
- [Model catalog](https://runapi.ai/ko/models)
- [API docs](https://runapi.ai/ko/docs)