HiAPI API를 통해 happyhorse-1.1/reference-to-video 사용하기: 프롬프트 레시피와 숏폼 워크플로

reference-to-video가 워크플로에 가져오는 변화

순수 텍스트 기반 영상 생성은 모델이 설명만으로 주체를 무에서 창조해야 하므로, 매 실행마다 얼굴, 의상, 제품 형태가 달라질 수 있습니다. reference-to-video는 정반대입니다. 하나 이상의 이미지를 제공하면 모델이 이를 화면에 등장하는 내용의 시각적 기준으로 삼습니다. 프롬프트는 더 이상 캐스팅 요구 사항이 아니라 감독 지시서가 됩니다.

숏폼 제작流程에서 이는 작업의 중심을 바꿉니다. 순수 텍스트 생성에서는 주로 표현을 반복 개선합니다. happyhorse-1.1/reference-to-video를 사용할 때는 참조 이미지 세트를 먼저 반복 개선하고, 그다음이 프롬프트입니다. 주체가 잘못 보인다면 해결책은 보통 더 긴 형용사 목록을 쌓는 것이 아니라 더 나은 이미지를 바꾸거나 이미지 순서를 조정하는 것입니다.

적용 위치

전형적인 순환은 대략 다음과 같습니다:

1. 주체와 장면을 위한 작은 참조 이미지 세트를 수집하고 선별합니다.
2. 중요도 순으로 정렬합니다(다음 절에서 자세히 설명).
3. 샷 순서대로 프롬프트를 작성하며 안정적인 속성과 리듬을 명시합니다.
4. 생성하고, 참조 이미지와 대조해 검토한 뒤, 이미지를 바꿀지 텍스트를 바꿀지 결정합니다.

실질적인 이점은 시리즈 콘텐츠의 일관성입니다. 동일한 인물, 제품, 마스코트가 등장하는 여러 영상을 제작한다면, 안정적인 참조 이미지 세트가 세 번째 에피소드도 첫 번째 에피소드처럼 보이게 하는 핵심입니다. 이미지는 일회용 업로드 파일이 아니라 저장소에서 버전 관리되는 자산으로 다루세요.

참조 이미지 세트 구성하기

모델은 이미지를 우선순위가 있는 신호로 읽습니다. 정렬과 선택 자체가 프롬프트의 일부이므로 의도적으로 결정해야 합니다.

주요 주체 이미지 한 장 고르기

첫 번째 이미지는 주체가 가장 선명하고 대표적인 뷰여야 합니다: 정면, 좋은 조명, 가림 없음, 배경에 주의를 분산시키는 잡동사니 없음. 이 이미지가 정체성을 고정합니다. 나머지 이미지는 보조 정보입니다.

실제로 가치가 있을 때만 두 번째 시점 추가하기

두 번째 이미지가 첫 번째로 해소되지 않는 모호성을 해결할 때—예를 들어 측면 뷰, 다른 의상 상태, 제품 뒷면—유용합니다. 상충하는 세부 사항을 도입할 때—예를 들어 두 가지 헤어스타일이나 두 개의 로고—해롭습니다. 모델이 둘을 평균 내길 원하지 않는다면 두 장을 동시에 넣지 마세요.

주체와 환경 분리하기

장면이 중요하다면 주체와 주의를 다투지 않으면서 설정을 보여주는 환경 참조 이미지를 추가하세요. 모델이 둘을 섞지 않도록 시각적으로 주체 이미지와 뚜렷이 구분되게 하세요.

간단한 정렬 경험칙

• 1번: 주요 주체, 깔끔하고 표준적.
• 2번: 주체의 보조 시점, 필요할 때만 추가.
• 3번 이후: 환경 또는 스타일링 참조.

여러 번의 반복을 아끼는 규범

• 참조 이미지 세트를 작고 내부적으로 일관되게 유지하세요.
• 주체가 너무 작거나, 크롭이 이상하거나, 필터가 과한 이미지는 피하세요.
• 가능한 한 화면 비율을 통일하세요. 차이가 큰 구도는 모델이 서로 다른 뷰를 조화시키기 어렵게 만듭니다.
• 역할별로 파일 이름을 지정하세요(subject-primary.png, scene-street.png). 팀이 이를 하나의 소재 세트로 다루게 됩니다.

확신이 없으면 이미지를 한 장 추가하기보다 한 장 삭제하세요.

주체 일관성을 유지하는 프롬프트 작성하기

정체성 드리프트는 대개 모호한 표현에서 비롯됩니다. "한 사람"이나 "세련된 의상" 같은 두루뭉술한 설명은 모델에게 즉흥적으로 만들 여지를 줍니다. 해결책은 안정적이고 관찰 가능한 속성을 명시하고 문장 간에 일관되게 유지하는 것입니다.

변하지 말아야 할 것을 지목하기

주체를 정의하는 속성을 나열하세요: 의상 색상과 재단, 헤어스타일, 시그니처 액세서리, 제품 형태, 로고 위치. 연속성을 당연시하지 말고 각 샷 설명에서 핵심 항목을 반복하세요.

"고정"과 "가변" 구분하기

머릿속에서 프롬프트를 두 부분으로 나누세요: 고정된 주체 속성, 그다음 샷별 동작과 카메라. 이렇게 하면 언제 실수로 모순을 도입했는지 쉽게 발견할 수 있습니다. 예를 들어 첫 샷에는 빨간 재킷, 세 번째 샷에는 회색 재킷을 쓴 경우입니다.

효과적인 표현 패턴

• 먼저 고정: 시작 부분에 주체와 고정 속성을 쓴 뒤 움직임을 설명하세요.
• 명사 일관성 유지: 참조 이미지가 트렌치코트를 보여준다면 매번 트렌치코트라고 부르세요. 처음에 "재킷"이라 하고 나중에 "외투"라고 하지 마세요.
• 평가보다 구체성: "어두운 단발, 옆 가르마"가 "예쁜 머리"보다 낫습니다.
• 움직임 속에서 변하지 않는 부분 설명: "주체가 돌아설 때 코트가 원래 실루엣을 유지"가 모델이 스스로 추론하길 기대는 것보다 유용합니다.
• 유의어 중첩 피하기: 형용사를 겹치면 신호가 희석됩니다.

빠른 비교

약함: "거리에서 걷는 세련된 여성, 시네마틱."

강함: "참조 이미지의 여성—어두운 단발, 옆 가르마, 카멜 트렌치코트, 검은 부츠—이 안정된 걸음으로 카메라 쪽으로 걸어온다; 코트와 부츠는 내내 일관되게 유지된다."

두 번째 버전은 모델에게 분위기가 아니라 체크리스트를 줍니다.

하나의 프롬프트에서 카메라와 리듬 지도하기

숏폼의 성패는 리듬에 달려 있습니다. 단일 정적 설명은 구조 없이 표류하는 영상을 만듭니다. 프롬프트를 순서가 있는 샷 시퀀스로 쓰고 명확한 리듬 힌트를 주세요.

비트 단위로 구성하기

두세 개에서 네 개의 비트를 설명하고, 각 비트에 주체 상태, 동작, 카메라 노트를 포함하세요. 각 비트는 짧게 유지하세요. 모델은 명확한 3박자 시퀀스를 한 덩어리의 긴 글보다 더 잘 처리합니다.

리듬을 명확히 쓰기

리듬 단어는 무게가 있습니다: "빠른 전환", "느린 푸시인", "한 박자 머무름", "급격한 줌", "안정적인 마무리". 이를 카메라 언어(달리, 팬, 핸드헬드)와 결합해 움직임과 시간감이 서로를 강화하게 하세요.

비트 템플릿

샷 1(0-2초): [주체 + 고정 속성] [동작], [카메라 움직임], [리듬 힌트].
샷 2(2-4초): [주체 상태 변화] [동작], [카메라 움직임], [리듬 힌트].
샷 3(4-6초): [마무리 비트], [카메라 안정], [리듬 힌트].

정확한 타임스탬프는 필요 없지만 초 단위로 생각하면 각 비트에 이유를 부여하게 됩니다. 어떤 비트에 명확한 시각적 변화가 없다면 삭제하세요.

흔한 리듬 실수

• 숏폼에 너무 많은 비트를 넣어 모델이 모든 것을 빠르게 몰아가도록 강요하는 것.
• 카메라 지시가 없어 구도가 평평하고 정적인 것.
• 같은 줄에 모순되는 리듬 힌트("느리지만 활기차게")를 넣는 것.

시퀀스를 다 쓴 뒤 소리 내어 읽고, 화면 내용을 바꾸지 않는 부분은 모두 삭제하세요.

해상도, 길이, 예산의 절충

대량 생성 전에 어떤 자원을 쓸지 먼저 결정하세요: 픽셀, 초, 또는 반복 횟수. 이들은 서로 경쟁합니다.

핵심 절충

더 높은 출력 해상도(예: 1080P)와 더 긴 길이는 모두 생성당 비용을 높입니다. 과금은 요청한 출력—해상도와 클립 길이 포함—을 따르므로, 긴 1080P 영상은 요청할 수 있는 가장 비싼 것입니다. 숏폼에서는 둘 다 최대로 올릴 필요가 거의 없습니다.

효과적인 결정 순서

1. 길이를 먼저 정하세요. 숏폼은 보통 짧은 시간 창을 의미합니다. 플랫폼이 요구하는 길이를 고정하고 나머지는 모두 조정 가능 항목으로 취급하세요.
2. 전달 목표에 따라 해상도를 선택하세요. 클립이 피드에서 어차피 압축된다면 낮은 해상도가 더 현명한 기본값일 수 있고, 예산을 더 많은 시도에 쓸 수 있습니다.
3. 예산을 결과물뿐 아니라 반복에 쓰세요. 약간 낮은 해상도로 세 번 생성해 최고 결과를 고르는 영상이, 비싸지만 다시 만들 수 없는 한 번의 시도보다 나을 때가 많습니다.

실용 조언

• 낮은 해상도로 프로토타입을 만들어 프롬프트와 참조 이미지 세트를 검증하세요.
• 샷 시퀀스와 정체성 일관성이 모두 통과한 뒤에만 1080P로 올리세요.
• 길이에 정직하세요: 비트가 명확한 짧은 영상이 채우기 내용으로 가득한 긴 영상보다 보기 좋습니다.

정확한 요율은 현재 가격 패널을 확인하세요. 숫자는 변하므로 스크립트에 하드코딩하지 마세요. 요청을 구성할 때 해상도와 길이를 코드에 박힌 상수가 아니라 전환 가능한 파라미터로 두세요.

실행 가능한 요청과 프롬프트 레시피 라이브러리

다음은 HiAPI API를 통해 happyhorse-1.1/reference-to-video를 호출하는 요청 구조이며, 이어서 위 워크플로에 맞춘 바로 복사 가능한 프롬프트 레시피입니다. 파라미터 이름은 SDK 버전에 따라 약간 다를 수 있으니 모델 페이지에서 규격 스키마를 확인하세요.

요청 구조

import os, requests

resp = requests.post(
    "https://api.hiapi.ai/v1/video/generations",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "happyhorse-1.1/reference-to-video",
        "reference_images": [
            "https://your-cdn.example/subject-primary.png",
            "https://your-cdn.example/subject-angle.png",
            "https://your-cdn.example/scene-street.png",
        ],
        "prompt": "...레시피 텍스트...",
        "resolution": "1080P",
        "duration": 6,
    },
)
print(resp.json())

참조 이미지를 안정적인 URL에 유지하고 앞서 설명한 순서대로 정렬하세요: 주요 주체, 보조 시점, 환경.

레시피 1: 제품 키 비주얼, 단일 비트

참조 이미지의 제품—무광 검정 병, 구리색 캡, 전면 라벨—이 돌 표면 위 중앙에 놓여 있다. 라벨로 천천히 푸시인, 부드러운 스튜디오 조명, 컷 없음. 병과 캡은 내내 정확한 형태와 색상을 유지한다.

레시피 2: 인물 걷기, 세 비트

샷 1(0-2초): 참조 이미지의 여성—어두운 단발, 옆 가르마, 카멜 트렌치코트, 검은 부츠—이 카메라 쪽으로 걸어온다, 미디엄 샷, 안정된 핸드헬드, 경쾌한 걸음.
샷 2(2-4초): 측면으로 빠른 전환; 그녀가 돌아설 때 트렌치코트가 휘날린다, 카메라가 옆으로 따라간다, 같은 경쾌한 리듬.
샷 3(4-6초): 그녀가 멈추고 정면을 향한다, 카메라가 느린 푸시인으로 안정되며 차분하게 마무리. 머리, 트렌치코트, 부츠는 모든 샷에서 일관되게 유지된다.

레시피 3: 환경으로 여는 오프닝

샷 1(0-2초): 환경 참조 이미지의 거리 광각 샷, 아침 햇살, 왼쪽으로 느린 팬.
샷 2(2-4초): 참조 이미지의 주체가 화면 오른쪽에서 들어온다—같은 재킷과 가방—카메라는 고정, 자연스러운 리듬.
샷 3(4-6초): 미디엄 샷으로 좁혀지며 그녀가 카메라를 바라본다; 재킷과 가방은 참조 이미지와 완전히 일치한다.

프롬프트 텍스트를 수정하지 않고도 클립별로 길이와 해상도를 조정할 수 있습니다. 문서에는 전체 예제가 포함된 전용 가이드가 제공됩니다.

결과물 검토 및 반복

검토는 품질 향상의 대부분이 일어나는 곳이며, 핵심 규율은 어떤 종류의 문제인지 판단하는 것입니다.

기억이 아니라 참조 이미지와 대조해 평가하기

참조 이미지 세트를 결과물 옆에 열어 두세요. 정체성 속성을 항목별로 확인하세요: 얼굴과 머리, 의상 색상과 재단, 제품 형태, 로고 위치. 이름 붙일 수 있는 드리프트가 고칠 수 있는 드리프트입니다.

실패를 두 가지로 분류하기

• 정체성 또는 외관 문제는 보통 참조 이미지 세트가 약하거나, 일관되지 않거나, 정렬이 잘못되었음을 의미합니다. 이미지를 먼저 고치세요; 프롬프트를 더 강하게 쓰는 것으로는 자기모순적인 참조 이미지 세트를 거의 구제할 수 없습니다.
• 구도, 움직임, 리듬 문제는 보통 프롬프트 개선이 필요하다는 의미입니다: 더 명확한 비트, 더 강한 카메라 노트, 더 타이트한 길이.

간단한 검토 루프

1. 정체성, 구도, 리듬을 각각 평가하세요.
2. 정체성이 불합격이면 프롬프트를 건드리기 전에 참조 이미지를 먼저 조정하세요.
3. 리듬이 불합격이면 비트 시퀀스를 다시 쓰고 비트 하나를 삭제하세요.
4. 각 반복에서 변수 하나만 바꿔야 무엇이 효과가 있었는지 알 수 있습니다.
5. 낮은 해상도에서 안정되면 최종 버전을 위해 1080P로 올리세요.

통과한 클립마다 프롬프트 버전과 참조 이미지 세트 버전의 간단한 로그를 남기세요. 시리즈에서 이 로그가 진짜 레시피 라이브러리가 됩니다: 신뢰할 수 있는 프롬프트, 신뢰할 수 있는 이미지, 예측 가능한 결과물. 참조 이미지 세트와 텍스트를 반복 개선하고, 나머지는 모델에 맡기세요.