HiAPI
블로그

사용 가이드

HappyHorse 1.1 이미지-투-비디오로 hiapi API를 통해 숏폼 비디오 만들기

첫 프레임 이미지 기반 이미지-투-비디오 워크플로우로, 두 개의 실제 클립과 바로 실행 가능한 API 예제, 확인된 가격 정보를 포함합니다.

Sep 16, 2026
HappyHorse 1.1 이미지-투-비디오로 hiapi API를 통해 숏폼 비디오 만들기

TL;DR

  • 이것은 무엇인가: hiapi API의 happyhorse-1.1/image-to-video를 기반으로 한 실제 사용 가능한 이미지-투-비디오 워크플로우입니다——상품 사진이나 인물 사진 한 장을 네이티브 오디오가 포함된 숏폼 비디오로 바꿔 TikTok, Reels 또는 상품 페이지에 바로 사용할 수 있습니다.
  • 왜 텍스트-투-비디오가 아닌 이미지-투-비디오인가: 이미 정확한 장면——책상 위의 상품, 인물 사진——을 가지고 있을 때는 구도를 정적 이미지에 먼저 고정하고 모델이 움직임을 더하게 하는 편이, 처음부터 전체 장면을 설명하는 것보다 훨씬 예측 가능한 결과를 냅니다.
  • 작업 구조는 단순합니다: image_urls(정확히 한 장의 첫 프레임 이미지), 움직임을 유도하는 선택적 prompt, resolution(720p/1080p), 그리고 duration(3-15초, 기본 5초). 모션 강도 슬라이더도, 카메라 경로 설정도 없습니다.
  • 가격(2026-09 기준): 720p는 초당 $0.16, 1080p는 초당 $0.21이며 duration으로 과금됩니다——아래와 같은 4초 720p 클립은 $0.64입니다. 대량 작업을 계획하기 전에 반드시 hiapi의 실시간 가격 페이지를 확인하세요. 요율이 변경될 수 있습니다.
  • 오디오는 네이티브입니다: HappyHorse 1.1은 움직임과 동기화된 사운드를 함께 생성합니다——별도 오디오 단계도, 추가로 설정할 필드도 없습니다.

두 가지 실제 예제: 상품 사진과 인물 사진

아래는 이 글에서 hiapi API를 통해 엔드투엔드로 생성한 두 클립입니다——같은 모델, 서로 다른 두 개의 첫 프레임, 서로 다른 두 가지 움직임 의도입니다. 둘 다 정적 썸네일이 아닌 실제 재생 가능한 비디오로 삽입되어 있습니다.

예제 1: 상품 사진을 홍보 영상으로 바꾸기

간단한 상품 사진——충전 케이스에 담긴 무선 이어버드 한 쌍——에서 시작해, 충전 케이스가 평면 이미지로 멈춰 있지 않고 느린 시네마틱 리빌을 하도록 모델에 요청합니다.

사용한 프롬프트:

Slow cinematic camera push-in on the matte-black wireless earbuds charging case, the lid opens smoothly on its own revealing the earbuds inside, a soft light sparkle highlight sweeps across the glossy lid, subtle studio light shift, smooth stable motion, no text, no logo, commercial product video style

이런 클립은 원래 실제 상품 촬영——슬라이더 장비와 조명 세팅——이 필요했지만, 여기서는 정적 사진 한 장과 텍스트 프롬프트 하나만 있으면 됩니다. 이커머스에서는 이 패턴(정적 대표 이미지 → 짧은 루프 동영상 클립)이 상품 페이지의 보조 소재나 네이티브 광고 크리에이티브로 잘 맞습니다. 요청이 전체 비디오 촬영이 아니라 4초 720p 생성 1회($0.64)로만 과금되기 때문입니다.

예제 2: 인물 사진에 생동감 불어넣기

두 번째 사용 사례는 토킹헤드나 모델 스타일 인물 사진입니다: 원래 정지해 있던 프로필 사진에 미세하고 자연스러운 생기를 더하고 싶을 때——살짝 돌아가는 고개, 번지는 미소, 흔들리는 머리카락——구도나 배경은 바꾸지 않으면서 말입니다.

사용한 프롬프트:

The woman turns her head naturally toward the camera with a soft warm smile, hair moves gently, natural blinking, subtle breathing motion, soft even studio lighting stays consistent, background stays plain and calm, no text

이 패턴은 팀 페이지, 크리에이터 프로필, 사용자 후기 영역 등에 쓰이는 프로필 사진 묶음을 짧고 손이 적게 가는 동적 소재로 바꾸는 데 적합합니다. 대상마다 촬영자를 섭외할 필요가 없습니다. image_urls가 정확히 한 장의 첫 프레임 이미지만 받기 때문에, 피사체의 정체성과 구도는 원본 사진에 고정됩니다. 모델은 움직임과 빛만 애니메이션화하고 장면을 재해석하지는 않습니다.

요청은 실제로 어떻게 생겼나

위 두 클립은 모두 hiapi의 통합 비동기 작업 API에 대한 동일한 형태의 요청에서 나왔습니다:

{
  "model": "happyhorse-1.1/image-to-video",
  "input": {
    "image_urls": ["https://static.hiapi.ai/blog/happyhorse-1-1-image-to-video-short-form-video/product-first-frame.jpg"],
    "prompt": "Slow cinematic camera push-in on the matte-black wireless earbuds charging case, the lid opens smoothly on its own revealing the earbuds inside, a soft light sparkle highlight sweeps across the glossy lid, subtle studio light shift, smooth stable motion, no text, no logo, commercial product video style",
    "resolution": "720p",
    "duration": 4
  }
}

POST /v1/tasks로 제출한 뒤, status가 종료 상태에 도달할 때까지 GET /v1/tasks/:id를 폴링하거나——프로덕션에서는 더 나은 방식으로——callback.url을 설정해 hiapi가 작업 완료 시 당신의 서비스에 알리도록 하세요. status=success일 때 완성된 클립은 output[0].url에 있습니다. URL에는 유효 기간이 있으므로 즉시 다운로드하세요.

숏폼 비디오에 맞는 해상도와 길이 선택하기

소셜 우선 숏폼 클립(TikTok, Reels, Shorts)에서는 720p에 스토리를 전달할 수 있는 가장 짧은 길이를 조합한 것이 보통 실용적인 기본값입니다——클립당 비용이 더 저렴하고, 소셜 플랫폼은 어차피 비디오를 재압축하기 때문에 업로드 후 추가적인 1080p 디테일은 거의 눈에 띄지 않습니다. 클립이 상품 페이지나 유료 광고에 쓰여 시청자가 큰 화면에서 전체 화면으로 볼 가능성이 있을 때 1080p를 선택하세요. 여기서는 해상도보다 길이가 더 큰 비용 레버입니다: 4초에서 8초로 늘리면 어느 해상도 등급에서든 비용이 대략 두 배가 됩니다. 따라서 움직임 아이디어를 명확히 전달할 수 있는 가장 짧은 클립부터 시작하고, 정말로 추가 초가 필요할 때만 늘리세요.

자주 묻는 질문

이미지-투-비디오에는 이미지가 몇 장 필요한가요? image_urls를 통해 정확히 한 장의 첫 프레임 이미지(JPEG/PNG/WEBP, 짧은 변 ≥300px, ≤20MB)가 필요합니다. SVG는 지원되지 않습니다. 전체 클립이 이 프레임에서부터 생성됩니다.

출력에 오디오가 포함되나요? 포함됩니다——HappyHorse 1.1은 움직임과 함께 네이티브 동기화 오디오를 생성하며, 추가로 설정할 필드가 없습니다.

텍스트-투-비디오나 레퍼런스-투-비디오와 무엇이 다른가요? 이미지-투-비디오는 한 장의 첫 프레임 이미지로 구동되므로, 원하는 정확한 구도를 이미 알고 있을 때 올바른 선택입니다. 시작 이미지 없이 순수 텍스트 설명에서 비디오를 생성하려면 happyhorse-1.1/text-to-video를 사용하세요. 여러 레퍼런스(최대 9장 이미지)로 피사체/스타일을 정밀 제어하려면 happyhorse-1.1/reference-to-video를 사용하세요.

클립 하나에 실제로 얼마가 드나요? 2026-09 기준, hiapi는 HappyHorse 1.1 이미지-투-비디오에 대해 duration으로 과금하며, 초당 $0.16(720p) 또는 초당 $0.21(1080p)입니다. 위 두 예제 클립은 모두 720p 4초이므로 각각 $0.64입니다. 대량 실행 전에 실시간 가격 페이지를 확인하세요. 초당 요율이 업데이트될 수 있습니다.

핵심 요점

  • 이미 정확한 장면——상품 사진, 프로필 사진——을 가지고 있고 그것을 움직이게만 하고 싶을 때는 텍스트-투-비디오 대신 이미지-투-비디오를 선택하세요.
  • image_urls는 정확히 한 장의 첫 프레임 이미지만 받습니다. 레퍼런스 이미지 배열은 받지 않습니다(그것은 reference-to-video의 용도입니다).
  • 모든 클립에 오디오가 무료로 포함됩니다——별도 오디오 생성 단계가 없습니다.
  • 길이가 주요 비용 레버입니다: 720p 4초 짧은 클립은 $0.64이며, 비용은 해상도 등급보다 초 수에 대략 선형으로 비례합니다.
  • 숏폼 비디오 파이프라인을 위해 여러 비디오 모델 중에서 선택 중이라면, 이 워크플로우를 Veo 3.1 Lite의 이미지-투-비디오 파이프라인이나 Seedance-2.0-Fast와 비교해 보세요.

직접 시도해 볼 준비가 되셨나요? API 키를 발급받고 정적 사진 한 장을 happyhorse-1.1/image-to-video로 보내세요——첫 클립 테스트에 몇 센트면 충분합니다.

영구 AI 아티팩트로 빌드 시작하기

API 키를 받아 태스크 기반의 하나의 API로 이미지, 비디오, 오디오 모델을 호출하세요.

API 문서 보기