img_uuid를 저장한 다음, 결과를 확인하기 위해 폴링하거나 HTTPS 콜백을 수신하세요.비디오 생성을 위한 HappyHorse 1.1 API
텍스트-비디오, 첫 프레임 이미지-비디오 또는 별도의 참조 이미지 워크플로우를 위해 독립적인 GoEnhance 오픈 API를 통해 HappyHorse 1.1 API에 액세스하세요. 비동기 작업을 제출하고 반환된
API 키 생성
올바른 HappyHorse API 모드 선택
텍스트-비디오
필수 프롬프트와 함께 model: happyhorse-1-1을 전송하고 image_url은 포함하지 마세요. 생성할 비디오의 문서화된 비율, 지속 시간 및 해상도를 선택하세요.
첫 프레임 이미지-비디오
첫 프레임을 애니메이션화하려면 image_url을 추가하세요. 이미지는 JPEG, PNG 또는 WEBP 형식이어야 하며, 최소 300px 이상, 10MB 미만, 그리고 문서화된 1:2.5에서 2.5:1 비율 범위 내여야 합니다.
참조 이미지 비디오
image_urls에 1~9개의 URL을 포함하여 model: happyhorse-1-1-ref를 사용하세요. 프롬프트에서 각 소스를 [Image 1], [Image 2] 등으로 참조하세요.
프로덕션 큐에 작업을 보내기 전에 선택한 요청 모드를 검증하세요.
HappyHorse 1.1 API 기능 및 제한 사항
두 가지 표준 입력 모드
텍스트-비디오에는 프롬프트만 사용하거나, 첫 프레임 이미지-비디오에는 <code>image_url</code>을 하나 추가하세요.
별도의 다중 참조 모델
1~9개의 필수 참조 이미지 URL과 함께 <code>happyhorse-1-1-ref</code>를 사용하세요. 순수 텍스트-비디오는 지원하지 않습니다.
3~15초 지속 시간
<code>duration</code>을 3에서 15초 사이의 정수로 설정하세요. 문서화된 기본값은 5초입니다.
720p 또는 1080p 출력
<code>720p</code> 또는 <code>1080p</code>를 선택하세요. 문서화된 기본값은 <code>720p</code>입니다.
세로, 정사각형 및 가로 비율
표준 경로는 16:9, 9:16, 1:1, 4:3 및 3:4를 지원합니다. 참조 모드에는 4:5 및 5:4도 나열되어 있습니다.
폴링 및 콜백
<code>img_uuid</code>를 유지하고 작업 상세 엔드포인트를 폴링하거나, 상태 업데이트를 위해 공개 HTTPS 콜백 URL을 제공하세요.
GoEnhance는 초당 가격을 토큰당 $0.02로 명시하고 있으며, 현재 이 요금을 기간 한정 혜택으로 표시하고 있습니다.
HappyHorse 1.1 API 가격
720p: 초당 $0.104
720p 생성은 초당 5.2 토큰을 사용합니다. 5초 요청 시 26 토큰이 사용되며, 문서화된 환율 기준으로 $0.52가 소요됩니다.
1080p: 초당 $0.144
1080p 생성은 초당 7.2 토큰을 사용하며, 이는 생성된 초당 $0.144에 해당합니다.
재생 시간별 추정
선택한 초당 요금에 요청한 3~15초의 재생 시간을 곱하십시오. 프로모션 가격은 변경될 수 있으므로 프로덕션 배치 작업 전에 실시간 API 참조를 확인하십시오.
HappyHorse 1.1 API 통합
1
1. API 키 생성 및 보호
GoEnhance 키를 생성하고 신뢰할 수 있는 서버 측 코드에서 Bearer 인증으로 전송하십시오.
2
2. 모델 선택
프롬프트 전용 또는 첫 프레임 생성에는
happyhorse-1-1을 선택하고, 1~9개의 참조 이미지를 사용하는 경우에는 happyhorse-1-1-ref를 선택하십시오. 3
3. 페이로드 구축 및 검증
필수 프롬프트를 제공한 다음, 선택한 모드에 맞는 이미지 필드, 재생 시간, 해상도, 비율 및 콜백 URL을 검증하십시오.
4
4. 비디오 작업 제출
https://api.goenhance.ai/api/v1/videos/generations에 POST 요청을 보내고 반환된 img_uuid를 저장하십시오. 5
5. 상태 추적
GET https://api.goenhance.ai/api/v1/jobs/detail?img_uuid=...를 폴링하거나 공개 HTTPS 콜백을 통해 상태 변경 사항을 수신하십시오. 6
6. 최종 결과 처리
성공 및 실패 결과를 멱등성 있게 처리하고, 반환된 에셋을 검증하며, 폴링과 콜백이 겹칠 때 다운스트림 작업이 중복되지 않도록 하십시오.
구조화된 생성 요청을 검토, 스토리지 및 전달 워크플로우에 연결하십시오.
HappyHorse API를 위한 개발자 사용 사례
캠페인 비디오 변형
크리에이티브 검토 및 다운스트림 편집을 위해 구조화된 프롬프트에서 짧은 모션 컨셉을 생성하십시오.
제품 및 브랜드 모션
백엔드에서 재생 시간, 해상도 및 완료 처리를 제어하면서 승인된 첫 프레임에 애니메이션을 적용하십시오.
캐릭터 상호작용 연구
참조 모델을 사용하여 승인된 소스 이미지의 피사체가 한 장면에서 어떻게 함께 나타나야 하는지 설명하십시오.
스토리보드 사전 시각화
더 큰 프로덕션 워크플로우를 시작하기 전에 샷 설명을 검토 가능한 클립으로 전환하십시오.
현지화된 크리에이티브 파이프라인
작업 제출 및 모니터링을 일관되게 유지하면서 지역별 변형을 위해 프롬프트를 매개변수화하십시오.
자동화된 에셋 대기열
백엔드 서비스에서 생성, 작업 상태 지속성, 콜백, 스토리지 및 사람의 승인 과정을 연결하십시오.
가격 책정, 요청 모드, 입력 제한 및 비동기 작업 처리에 대한 답변입니다.