---
title: "OpenClaw에서 RunAPI로 Hailuo 사용하기 — 영상 API 가이드"
url: "https://runapi.ai/ko/openclaw-hailuo.md"
canonical: "https://runapi.ai/ko/openclaw-hailuo"
locale: "ko"
model: "hailuo"
---

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

MiniMax의 Hailuo 02는 텍스트 또는 이미지로부터 1080p의 6초 영상을 생성합니다 — 시네마틱 카메라 워크, 일관된 캐릭터 렌더링, 부드러운 모션. OpenClaw 에이전트는 채팅에 사용하는 것과 동일한 RunAPI key로 호출합니다.

## API example

```bash
curl -X POST https://runapi.ai/api/v1/hailuo/text_to_video \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "hailuo-02-text-to-video-pro",
    "prompt": "A glass marble rolls across a wooden desk, catches the edge, and falls in slow motion. Camera follows the marble. Soft window light, shallow depth of field."
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "hailuo-02-text-to-video-pro"
}

```

## How it works

1. **RunAPI 설정** — 환경에 RUNAPI_API_KEY를 설정하세요. RunAPI가 이미 OpenClaw 채팅 프로바이더라면, 동일한 key로 Hailuo 영상도 지원됩니다 — 추가 설정이 필요 없습니다.
2. **Hailuo text_to_video 호출** — /api/v1/hailuo/text_to_video에 model을 hailuo-02-text-to-video-pro와 프롬프트로 POST 요청을 보내세요. 이미지-비디오의 경우, /api/v1/hailuo/image_to_video를 사용하고 first_frame_image_url을 포함하세요.
3. **결과 가져오기** — 엔드포인트는 task_id를 반환합니다. 상태가 completed가 될 때까지 폴링한 후 영상 URL을 가져오세요. 6초 1080p 클립 생성에는 일반적으로 30~90초가 소요됩니다.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | 필수. hailuo-02-text-to-video-pro 또는 hailuo-02-text-to-video-standard. |
| `prompt` | `string` | 장면 설명. 이미지-비디오 모드를 사용하지 않는 경우 필수. |
| `first_frame_image_url` | `string` | 이미지-비디오 모드를 위한 첫 번째 프레임 이미지 URL. |
| `last_frame_image_url` | `string` | 선택 사항. 마지막 프레임으로 사용할 이미지의 URL. Hailuo 02 image-to-video에서만 사용 가능. |
| `duration_seconds` | `integer` | 선택 사항. 영상 길이(초). 허용 값: 6 또는 10. standard에서 기본값은 10, pro에서는 고정. |
| `output_resolution` | `string` | 출력 화면 비율. 허용 값: 16:9, 9:16, 1:1. |
| `callback_url` | `string` | 선택 사항. 작업 완료 시 POST를 수신하는 웹훅 URL. |

## FAQ

### Hailuo 02란 무엇이며 이전 버전과 어떻게 다른가요?

Hailuo 02는 MiniMax의 2세대 영상 모델입니다. 일관된 캐릭터 렌더링과 물리적으로 정확한 모션으로 시네마틱 1080p 클립을 출력합니다. Pro 티어는 프롬프트 방향에 대한 충실도가 더 높으며, Standard는 더 빠른 생성과 낮은 비용을 제공합니다.

### 이미지를 시작 프레임으로 사용할 수 있나요?

네. image_to_video 엔드포인트를 사용하고 first_frame_image_url을 전달하세요. Hailuo는 해당 프레임에서 순방향 모션을 생성하므로, 영상이 정확히 이미지에서 시작하여 거기서부터 애니메이션이 생성됩니다.

### Hailuo 생성에는 얼마나 걸리나요?

6초 1080p 클립의 경우 일반적으로 30~90초가 소요됩니다. 많은 병렬 작업을 실행 중인 경우, 큐 지연으로 몇 초가 추가될 수 있습니다. 상태 엔드포인트는 실시간 상태를 반영합니다 — 5~10초마다 폴링하세요.


## Links

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