사용 가이드
海螺 2.3 이미지-투-비디오 프롬프트: 바로 복사해 쓸 수 있는 3가지 레시피 (실제 출력 포함)
hailuo-2.3/image-to-video에 적용되는 세 가지 원패스 프롬프트 레시피—연속 태극 동작, 물리적 요구가 극도로 높은 강아지 물 털기, 그리고 수묵 삽화 애니메이션화—각 레시피에는 정확한 동작 프롬프트, 내장된 출력 클립, 검증된 단일 클립 가격이 포함되어 있습니다.
해울로 2.3(hailuo-2.3/image-to-video)은 MiniMax의 표준 이미지-투-비디오 티어로, 대표 능력은 동작 물리입니다: 옷감, 머리카락, 물, 그리고 전신 움직임이 눈이 기대하는 대로 구현됩니다. 이 글은 그대로 따라 쓸 수 있는 실전 매뉴얼로, 표준 티어에 적용되는 hailuo 이미지-투-비디오 프롬프트를 담고 있습니다—연속 인체 동작, 격렬한 물 물리, 그리고 스타일화된 삽화를 움직이게 하는 데 특화된 세 가지 즉시 복사 가능한 레시피입니다.
아래 각 클립은 옆에 표시된 프롬프트로 실제 환경에서 단 한 번 시도해 얻은 출력입니다—여러 번 실행해 가장 좋은 것을 고른 것이 아니며—각 가격은 게시 전에 실시간 가격 페이지와 대조해 검증되었습니다. 표준 티어는 클립 단위로 과금됩니다: 6초 $0.40, 10초 $0.80.
30초 만에 보는 입력 파라미터 구조
해울로 i2v는 hiapi의 비동기 작업 엔드포인트(POST /v1/tasks)로 실행되며, 입력 파라미터 구조는 의도적으로 간결하고 엄격하게 유지됩니다:
| 필드 | 필수 여부 | 설명 |
|---|---|---|
prompt |
예 | 동작을 설명하는 것이지 장면이 아닙니다—이미지 자체가 이미 장면입니다 |
image_url |
예 | 공개적으로 접근 가능한 URL(단수—image_urls 아님); 첫 프레임이 됩니다 |
duration |
아니오 | 문자열 "6" 또는 "10"—정수 6은 400으로 거부됩니다 |
prompt_optimizer |
아니오 | 불리언; 플랫폼이 생성 전에 프롬프트를 확장하도록 허용 |
그 외의 모든 것—resolution, aspect_ratio, motion_strength—은 400 INVALID_REQUEST: additional properties not allowed로 거부됩니다. 여기에는 동작 조절 노브가 없습니다: 프롬프트가 유일한 방향타이며, 이것이 바로 이 모델에서 프롬프트 레시피가 그토록 중요한 이유입니다. 출력 클립은 입력 프레임의 종횡비를 상속합니다(우리의 16:9 프레임은 1364×768로 렌더링됨). 전체 요청/폴링/다운로드 흐름은 hailuo-2.3 이미지-투-비디오 API 가이드를 참고하세요.
세 가지 레시피 모두에 통하는 프롬프트 공식:
주체 동작을 쓰여진 순서대로 설명(해울로는 대체로 중첩된 동작을 순서대로 실행합니다) + 한 가지 카메라 지시(푸시 인 / 고정 / 드리프트) + 일관성 조항(매끄럽고 자연스러운 동작, 프레임 전반에 일관된 조명)
이미지에 이미 있는 내용을 다시 설명하는 데 단어를 낭비하지 마세요. 화면 자체가 스타일을 담고 있으므로, 모든 프롬프트 토큰은 움직임과 교환되어야 합니다.
레시피 1—연속 전신 동작 (태극 흐름)
이미지-투-비디오에서 가장 어려운 작업은 지속적이고 협응된 인체 동작입니다—대부분의 모델은 한 번의 손동작을 해낸 뒤 뭉개지기 시작합니다. 이 레시피는 해울로 2.3이 고요한 자세에서 시작해 흩날리는 옷감과 함께 연속 무술 동작을 수행하도록 요구합니다:

동작 프롬프트:
he flows into a slow tai chi opening form, arms rising and sweeping in one
continuous circular motion, sleeves and sash trailing behind each movement,
ground mist swirling around his steps, slow cinematic push-in, smooth
natural motion, consistent warm dawn lighting across frames
원패스 출력($0.40, 6초):
주목할 점: 팔이 한 바퀴의 원형 궤적을 완전히 완수하고, 해부 구조가 무너지지 않으며, 소매가 실제 리넨처럼 팔보다 뒤처집니다—이러한 2차 옷감 움직임이 표준 티어의 특징입니다. "in one continuous circular motion"이라는 문구가 핵심입니다: 명시적인 연속성 힌트가 없으면 i2v 모델은 종종 한 번의 손동작을 한 뒤 멈추고 관련 없는 두 번째 손동작을 이어 붙이기 때문입니다. 옷감을 지목해야("sleeves and sash trailing") 옷감 시뮬레이션이 활성화됩니다; 언급하지 않으면 헐렁한 옷은 흔히 뻣뻣하게 유지됩니다.
레시피 2—물과 털 물리 (강아지 물 털기)
젖은 강아지의 물 털기는 가혹한 물리 테스트입니다: 고주파 신체 회전, 뭉친 털, 그리고 수십 개의 물방울이 각기 합당한 탄도 곡선을 그려야 합니다. 동시에 실제로 유용한 패턴이기도 합니다—반려동물 브랜드와 스톡 팀이 정지 이미지를 이렇게 움직이게 하곤 합니다:

동작 프롬프트:
the dog shakes water off its whole body, droplets spraying outward in
glittering arcs against the backlight, ears flapping, then it stops and
tilts its head at the camera, locked low-angle camera, smooth natural
motion, consistent golden-hour lighting
원패스 출력($0.40, 6초):
주목할 점: 튀는 물이 흐릿한 필터가 아니라 역광에 비친 개별 물방울처럼 실제 궤적을 지니고 보이며—클립은 대본 순서대로 실행됩니다(털기 → 멈춤 → 고개 갸우뚱). 여기에는 재사용 가능한 두 가지 요령이 있습니다. 첫째, "against the backlight"는 물이 단지 존재하는 것이 아니라 어떻게 보여야 하는지를 모델에 알려줍니다; 빛을 인식한 동작 설명은 보통 더 나은 입자를 렌더링합니다. 둘째, 작고 차분한 동작("tilts its head at the camera")으로 끝맺으면 클립이 털기 도중에 끊기는 대신 자연스러운 마무리 박자를 갖게 됩니다—클립이 제품 페이지에서 반복 재생될 때 유용합니다.
레시피 3—스타일화된 삽화를 움직이게 하기 (수묵 용)
해울로 i2v는 사진에만 적합한 것이 아닙니다. 스타일화된 정지 이미지—여기서는 구름 속 잉어 용의 수묵 삽화—를 입력하면 화면의 스타일로 애니메이션화하며, 붓 터치를 사진처럼 사실적으로 바꾸려 하지 않고 하나의 매체로 취급합니다:
동작 프롬프트:
The ink wash koi dragon slowly swims forward through the clouds, brush
strokes flowing like water, camera drifts right
출력($0.40, 6초):
주목할 점: 구름이 사진 속 안개처럼 행동하는 대신 젖은 먹처럼 번지고 재구성됩니다—"brush strokes flowing like water"가 장면 자체가 아니라 매체의 물리적 특성을 지목함으로써 이를 구현합니다. 삽화 입력의 경우 화면의 스타일이 주도하도록 프롬프트를 짧게 유지하세요; 장문의 사진 용어("cinematic", "bokeh")는 삽화와 충돌해 스타일 표류를 일으킬 수 있습니다. 바로 이것이 브랜드 마스코트, 도서 삽화, 게임 스플래시 화면에 활용할 수 있는 패턴입니다.
표준 티어 vs. 패스트 티어: $0.40이 가치 있는 때
hiapi는 hailuo-2.3-fast/image-to-video도 제공하며 가격은 $0.27/6초이고, 입력 파라미터 구조 역시 세 필드로 동일하므로 프롬프트를 두 티어 사이에서 그대로 옮길 수 있습니다. 잘 작동하는 워크플로우:
- 패스트 티어에서 프로토타이핑($0.27/클립)하며 동작 표현을 반복—파라미터 구조와 동작이 같으므로 노하우가 그대로 이전됩니다.
- 샷이 물리적 충실도에 의존할 때—다단계 인체 동작, 옷감, 레시피 2처럼 입자가密集한 장면—표준 티어에서 최종본을 다시 실행($0.40/클립).
- 두 티어 모두 초가 아니라 클립 단위로 과금—실패한 실험과 최종본의 비용이 같으므로, 저비용으로 프로토타이핑해야 하는 또 다른 이유입니다.
직접 실행하기
위 레시피 중 어느 것이든 요청 한 번이면 됩니다. 작업 생성:
curl -X POST https://api.hiapi.ai/v1/tasks \
-H "Authorization: Bearer sk-<your-key>" \
-H "Content-Type: application/json" \
-d '{
"model": "hailuo-2.3/image-to-video",
"input": {
"prompt": "the dog shakes water off its whole body, droplets spraying outward in glittering arcs against the backlight, ears flapping, then it stops and tilts its head at the camera, locked low-angle camera, smooth natural motion, consistent golden-hour lighting",
"image_url": "https://your-cdn.example.com/first-frame.jpg",
"duration": "6"
}
}'
그다음 GET /v1/tasks/<taskId>를 폴링해 data.status가 "success"가 될 때까지 확인하고, 즉시 data.output[0].url을 다운로드하세요—출력 URL은 서명되었고 만료되므로 바이트를 자신의 스토리지에 저장해야 합니다. 전체 폴링 및 오류 처리 코드는 API 흐름 설명과 문서를 참고하세요.
자주 묻는 질문
왜 제 duration이 거부되나요? 문자열 "6" 또는 "10"이어야 합니다. 정수나 "8" 같은 다른 값은 400을 반환합니다.
해상도나 종횡비를 제어할 수 있나요? 아니요—파라미터 구조에 그런 필드가 없습니다. 클립은 입력 프레임의 종횡비를 상속하므로, 생성 전에 정지 이미지를 원하는 화면비로 잘라 두세요.
입력 이미지가 공개되어야 하나요? 예. API가 서버 측에서 image_url을 가져오므로 localhost 경로와 만료된 서명 URL은 실패합니다. R2/S3/CDN 공개 링크라면 모두 괜찮습니다.
이 프롬프트가 패스트 티어에서도 유효한가요? 예, 그대로 사용 가능합니다—파라미터 구조가 같습니다. 입자가 많은 장면에서는 물리 효과가 약간 덜 정교합니다; 그것이 낮은 가격과 맞바꾼 트레이드오프입니다.
클립 하나에 얼마나 걸리나요? 초 단위가 아니라 분 단위입니다—우리의 6초 클립은 각각 몇 분의 폴링 안에 완료되었습니다. 블로킹 HTTP 대기 대신 비동기(폴링 또는 콜백)로 구축하세요.
위 세 클립은 모두 단일 시도에서 나왔고 각각 $0.40입니다—이 매뉴얼 전체의 생성 비용은 $1.20입니다. 움직이게 하고 싶은 정지 이미지가 있다면 키를 발급받고 hailuo-2.3/image-to-video 모델 페이지에서 시작하세요: 이미지 URL을 위 요청에 바꿔 넣고 동작(장면이 아님)을 설명하면, 커피가 식기 전에 첫 클립이 완성됩니다.
관련 글
모든 아티클 보기 →-
사용 가이드
seedream-5.0-pro/image-to-image 시작 가이드: 기능, 가격 및 연동 핵심 포인트
ByteDance 이미지 편집 모델의 기능 경계, 과금 방식 및 엔지니어링 연동 실무
-
사용 가이드
seedream-5.0-pro 텍스트-이미지 생성 입문 가이드: 능력 경계, API 연동 및 비용 관리
개발자를 위한 실무 관점: 파라미터 핵심부터 장당 $0.05 비용 추정까지
-
사용 가이드
Hailuo 2.3 Fast 이미지-투-비디오 입문 가이드: 성능 범위, 가격 및 연동 실무
개발자를 위한 MiniMax 이미지-투-비디오 모델 선택과 연동 핵심 포인트