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

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

Hailuo는 MiniMax의 영상 생성 모델로 6가지 변형(Hailuo 02와 2.3)에 걸쳐 정확한 물리 시뮬레이션으로 네이티브 1080p 영상을 생성합니다 — 텍스트-비디오와 이미지-비디오 엔드포인트가 pro와 standard 티어로 제공됩니다. Hermes Agent는 채팅에 설정한 동일한 key와 base URL을 사용하는 custom:runapi 프로바이더를 통해 RunAPI를 호출합니다.

## 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 환경 변수를 설정하세요. Hermes Agent에서 채팅용 custom:runapi 프로바이더로 RunAPI를 이미 추가했다면, 동일한 key와 base_url이 영상 생성에도 사용됩니다 — 추가 설정이 필요 없습니다.
2. **Hailuo text_to_video 또는 image_to_video 호출** — model을 hailuo-02-text-to-video-pro로 설정하고 장면을 설명하는 프롬프트와 함께 /api/v1/hailuo/text_to_video에 POST 요청을 보내세요. 이미지 기반 영상은 first_frame_image_url과 함께 image_to_video 엔드포인트를 사용하세요.
3. **결과 가져오기** — 엔드포인트는 즉시 task_id를 반환합니다. 상태가 completed로 변경될 때까지 작업 상태 엔드포인트를 폴링한 후 응답에서 생성된 영상 URL을 가져오세요. Pro 티어는 일반적으로 2분 이내에 완료됩니다.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | 필수. 다음 중 하나: hailuo-02-text-to-video-pro, hailuo-02-text-to-video-standard, hailuo-02-image-to-video-pro, hailuo-02-image-to-video-standard, hailuo-2.3-image-to-video-pro, hailuo-2.3-image-to-video-standard. |
| `prompt` | `string` | 필수. 영상 장면, 카메라 움직임, 조명에 대한 텍스트 설명. |
| `first_frame_image_url` | `string` | image_to_video 엔드포인트에서 필수. 첫 번째 프레임으로 사용할 소스 이미지 URL. |
| `last_frame_image_url` | `string` | 선택 사항. 마지막 프레임으로 사용할 이미지 URL. Hailuo 02 이미지-비디오에서만 사용 가능. |
| `duration_seconds` | `integer` | 선택 사항. 영상 길이(초). 허용 값: 6 또는 10. standard에서는 기본값 10, pro에서는 고정. |
| `output_resolution` | `string` | 선택 사항. 출력 해상도. 02 standard는 512p 또는 768p, 2.3 변형은 768p 또는 1080p. |
| `callback_url` | `string` | 선택 사항. 작업 완료 시 POST를 수신하는 웹훅 URL. |

## FAQ

### Hermes Agent에서 Hailuo를 사용할 수 있나요?

네. Hermes Agent에서 RunAPI를 custom:runapi 프로바이더로 설정한 후 Hailuo 모델 슬러그를 사용하여 text_to_video 또는 image_to_video 엔드포인트를 호출하세요. 채팅에 사용하는 동일한 RUNAPI_API_KEY가 영상 생성에도 사용됩니다.

### Hailuo 02와 Hailuo 2.3의 차이점은 무엇인가요?

Hailuo 02는 첫 번째 프레임과 마지막 프레임 제어가 포함된 텍스트-비디오와 이미지-비디오를 모두 지원합니다. Hailuo 2.3은 이미지-비디오 전용이지만 향상된 신체 모션, 미세 표정, 애니메이션과 일러스트 전용 렌더링 스타일이 추가됩니다.

### Standard 티어에서 길이 기반 가격 책정은 어떻게 작동하나요?

Standard 티어 가격은 duration_seconds에 따라 달라집니다. 텍스트-비디오 standard의 경우 6초 클립은 30센트, 10초 클립은 50센트입니다. 이미지-비디오 standard 가격은 output_resolution도 반영됩니다 — 6초 512p 클립은 12센트부터 시작합니다.

### Hermes Agent가 비동기 폴링을 자동으로 처리하나요?

아니요. Hailuo는 비동기로 작동합니다 — API는 즉시 task_id를 반환합니다. Hermes Agent 워크플로우에서 작업 상태 엔드포인트를 폴링하거나 callback_url을 제공해야 합니다. 일반적인 생성 시간은 60~120초입니다.

### Hailuo 영상의 첫 번째와 마지막 프레임을 모두 제어할 수 있나요?

Hailuo 02 이미지-비디오 엔드포인트에서만 가능합니다. first_frame_image_url과 last_frame_image_url을 함께 전달하여 시작과 끝 프레임을 정의하세요. Hailuo 2.3 이미지-비디오는 first_frame_image_url만 허용합니다.


## Links

- [Hermes Agent 설정 가이드 →](https://runapi.ai/ko/hermes-agent)
- [Hailuo 모델 →](https://runapi.ai/ko/models/hailuo)
- [Model catalog](https://runapi.ai/ko/models)
- [API docs](https://runapi.ai/ko/docs)