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만 허용합니다.

HERMES + HAILUO

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

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

API Key 받기 문서 읽기

하나의 API key · 텍스트-비디오 + 이미지-비디오 · 비동기 작업 폴링

Use RunAPI to generate a video with MiniMax Hailuo 02 Pro through Hermes Agent.

Requirements:
- Use the custom:runapi provider already configured in Hermes Agent
- Call the RunAPI text_to_video endpoint at https://runapi.ai/api/v1/hailuo/text_to_video
- Set model to "hailuo-02-text-to-video-pro"
- The RUNAPI_API_KEY environment variable provides authorization
- Include a detailed prompt describing camera movement and scene
- The response is async — poll the task status endpoint until the task completes, then retrieve the video URL

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."
  }'

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

curl 명령어를 복사하여 테스트하세요 hailuo

작동 방식

Hermes Agent에서 Hailuo를 세 단계로 사용하기

RunAPI 설정

RUNAPI_API_KEY 환경 변수를 설정하세요. Hermes Agent에서 채팅용 custom:runapi 프로바이더로 RunAPI를 이미 추가했다면, 동일한 key와 base_url이 영상 생성에도 사용됩니다 — 추가 설정이 필요 없습니다.

export RUNAPI_API_KEY=runapi_xxx

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 엔드포인트를 사용하세요.

POST /api/v1/hailuo/text_to_video

결과 가져오기

엔드포인트는 즉시 task_id를 반환합니다. 상태가 completed로 변경될 때까지 작업 상태 엔드포인트를 폴링한 후 응답에서 생성된 영상 URL을 가져오세요. Pro 티어는 일반적으로 2분 이내에 완료됩니다.

GET /api/v1/hailuo/text_to_video/tsk_abc123

파라미터

Hailuo API 파라미터

파라미터	유형	설명
`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.

Hermes Agent의 Hailuo란?

MiniMax의 Hailuo는 동급 최속 생성 속도·부드러운 모션 일관성·뛰어난 디테일 유지로 알려져 있습니다. Hermes Agent의 custom:runapi provider를 통해 텍스트 또는 이미지에서 네이티브 1080p 영상을 생성할 수 있으며, Hailuo 2.3은 전용 애니메이션·일러스트 렌더링 스타일을 추가합니다.