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

# OpenClaw에서 Luma를 사용하세요.

Luma Ray 3.2는 공간적 일관성과 3D 장면 구조를 보존하는 프롬프트 기반 변환으로 기존 영상을 수정합니다. 소스 영상 URL과 변환을 설명하는 텍스트 프롬프트를 전송하면 — Luma가 대기 조명, 환경 세부 사항, 물리적으로 일관된 카메라 모션으로 영상을 재렌더링합니다. OpenClaw 에이전트는 채팅에 사용하는 것과 동일한 RunAPI key로 호출합니다.

## 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 설정** — 환경에 RUNAPI_API_KEY를 설정하세요. OpenClaw에서 채팅용으로 RunAPI를 이미 설정했다면, 동일한 key로 Luma 영상 변환을 지원합니다 — 추가 프로바이더 설정이 필요 없습니다.
2. **Luma modify_video 호출** — modify_video 엔드포인트에 model을 luma-modify-video로 설정하고, source_video_url을 입력 영상으로 지정하고, 변환 내용을 설명하는 프롬프트와 함께 POST 요청을 보내세요. Luma는 요청된 변경 사항을 적용하면서 원본 장면 구조를 보존합니다.
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는 프롬프트 기반 변경으로 기존 영상을 재렌더링합니다 — 분위기 변화(안개, 비, 골든 아워), 스타일 전환(시네마틱, 애니메이션, 누아르), 조명 개편, 환경 변환. 원본 카메라 모션과 장면의 공간적 레이아웃을 보존합니다.

### Luma는 RunAPI의 다른 영상 모델과 어떻게 다른가요?

Luma는 처음부터 생성하는 것이 아닌 기존 영상 수정을 전문으로 합니다. Ray 3.2 모델은 변환 중에 3D 공간적 일관성을 유지하므로 객체가 깊이 관계를 유지하고 카메라 모션이 물리적으로 일관되게 유지됩니다. Kling이나 Hailuo 같은 모델은 텍스트나 이미지에서 새 영상을 생성합니다.

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

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

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

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

### 하나의 에이전트 워크플로우에서 Luma를 다른 RunAPI 영상 모델과 연결할 수 있나요?

네. OpenClaw 에이전트는 Kling이나 Hailuo로 영상을 생성한 후, 출력 URL을 Luma modify_video의 source_video_url로 전달하여 후처리할 수 있습니다 — 모두 동일한 RUNAPI_API_KEY를 통해. 각 단계는 동일한 비동기 폴링 패턴을 사용합니다.


## Links

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