[Image 1], [Image 2]와 같이 참조한 다음 img_uuid를 통해 비동기 작업을 추적하세요.HappyHorse 1.1 참조 API
독립적인 GoEnhance API를 통해 참조 가이드 비디오를 생성하세요. 1~9개의 공개 이미지 URL을 전송하고 프롬프트에서
API 키 받기
참조 기반 비디오 요청 빌드
1~9개의 참조 이미지로 움직임 가이드
model: happyhorse-1-1-ref와 함께 https://api.goenhance.ai/api/v1/videos/generations로 POST 요청을 보내세요. 필수 image_urls 배열은 1~9개의 공개 이미지 URL을 허용합니다.
구성 및 완성도 제어
프롬프트, 비율, 지속 시간 및 해상도를 설정한 후 반환된 img_uuid를 유지하세요. GET /api/v1/jobs/detail을 폴링하거나 공개 HTTPS URL에서 상태 변경 콜백을 수신하세요.
생성 작업을 제출하기 전에 모든 필드의 유효성을 검사하세요.
HappyHorse 1.1 참조 API 기능
참조 전용 입력 모드
이 경로는 <code>image_urls</code>가 필요하며 순수 텍스트 기반 비디오 생성은 지원하지 않습니다.
1~9개의 참조 이미지
프롬프트에서 사용하는 순서대로 1개에서 9개 사이의 공개 이미지 URL을 제공하세요.
인덱스된 프롬프트 참조
입력 항목을 <code>[Image 1]</code>, <code>[Image 2]</code> 등과 같이 명시적으로 참조하세요.
7가지 화면 비율
16:9, 9:16, 3:4, 4:3, 4:5, 5:4 또는 1:1 중 선택하세요. 기본값은 16:9입니다.
3~15초 지속 시간
3초에서 15초 사이의 정수 지속 시간을 설정하세요. 문서화된 기본값은 5초입니다.
720p 또는 1080p
720p 또는 1080p 출력을 선택하세요. 문서화된 기본값은 720p입니다.
가격은 문서화된 토큰당 $0.02 변환을 기준으로 생성된 초당 책정됩니다.
HappyHorse 1.1 참조 API 가격
720p 가격
생성된 초당 5.2 토큰, 초당 $0.104에 해당합니다.
1080p 가격
생성된 초당 7.2 토큰, 초당 $0.144에 해당합니다.
각 요청 추정
선택한 초당 요금에 지속 시간을 곱하세요. 예를 들어, 720p에서 5초는 26 토큰을 사용합니다.
6단계로 HappyHorse API 통합하기
1
1. API 키 생성
GoEnhance 키를 생성하고 Authorization 헤더에 베어러 토큰으로 전송하세요.
2
2. 참조 이미지 호스팅
필수 배열 순서에 맞춰 공개적으로 접근 가능한 이미지 URL을 1~9개 제공하세요.
3
3. 인덱스된 프롬프트 작성
각 입력을
[Image N]으로 명명하면서 동작과 관계를 설명하세요. 4
4. 출력 설정 검증
지원되는 비율, 3~15초의 지속 시간, 720p 또는 1080p 해상도를 선택하세요.
5
5. 제출 및 ID 유지
작업을 POST하고 완료 이벤트 처리 전에 반환된
img_uuid를 저장하세요. 6
6. 폴링 또는 콜백 수신
작업 상세 엔드포인트를 폴링하거나 공개 HTTPS 콜백 URL에서 상태 변경을 처리하세요.
승인된 시각적 입력을 중심으로 반복 가능한 비디오 워크플로우를 구축하세요.
HappyHorse 참조 API 사용 사례
캐릭터 연속성
승인된 캐릭터 참조를 사용하여 생성된 샷 전반에 걸쳐 정체성과 스타일을 유지하세요.
제품 스토리텔링
프롬프트 기반 비디오 컨셉에서 제품, 배경, 분위기 참조를 결합하세요.
캠페인 변형
단일 작업 핸들러를 유지하면서 창의적인 변형을 위해 참조 세트와 프롬프트를 매개변수화하세요.
스토리보드 개발
시각적 보드와 예술적 방향 참조를 검토용 짧은 모션 컨셉으로 전환하세요.
현지화된 크리에이티브
검증 및 완료 워크플로우를 유지하면서 승인된 지역별 참조를 교체하세요.
프리비주얼라이제이션
본격적인 제작에 들어가기 전에 여러 참조 대상 간의 상호작용을 탐색하세요.
입력, 가격 책정 및 비동기 통합에 관한 일반적인 질문에 대한 답변입니다.