img_uuid를 받은 다음 비동기 작업을 폴링하거나 콜백을 통해 상태 업데이트를 처리합니다. GoEnhance는 제3자 액세스를 제공하며 MiniMax 또는 공식 MiniMax API가 아닙니다.텍스트 및 이미지-투-비디오를 위한 Hailuo 2.3 API
독립적인 GoEnhance API를 통해 Hailuo 2.3에 액세스합니다. 텍스트 프롬프트를 제출하거나 첫 프레임 이미지를 추가하고
API 키 만들기
Hailuo 2.3 생성 모드 선택
hailuo_2_3을 사용한 텍스트-투-비디오
필수 프롬프트와 함께 model: hailuo_2_3을 보냅니다. 텍스트 전용 요청의 경우 선택적 ratio 필드가 출력 화면 비율을 설정합니다. 6초 또는 10초 결과에는 768P를, 6초 결과에는 1080P를 선택합니다.
첫 프레임을 사용한 이미지-투-비디오
해당 자산을 첫 프레임으로 사용하려면 HTTPS image_url을 추가합니다. 동일한 엔드포인트와 모델 ID가 요청을 처리하므로 하나의 연동으로 프롬프트 전용 및 첫 프레임 워크플로를 모두 지원할 수 있습니다.
생성 요청을 보내기 전에 모드, 재생 시간 및 해상도를 함께 검증합니다.
Hailuo 2.3 API 매개변수 및 검증
모델 및 프롬프트
<code>model</code>을 <code>hailuo_2_3</code>로 설정합니다. 모든 요청에는 비디오를 설명하는 텍스트 <code>prompt</code>가 필요합니다.
선택적 첫 프레임 이미지
이미지-투-비디오를 실행하려면 <code>image_url</code>을 제공합니다. 텍스트-투-비디오에서는 생략합니다. 값은 서비스에서 액세스할 수 있는 유효한 이미지 URL이어야 합니다.
재생 시간 규칙
<code>duration</code> 필드는 6초 또는 10초를 허용하며 기본값은 6초입니다. 1080P 요청은 6초만 지원합니다.
해상도 옵션
<code>768P</code> 또는 <code>1080P</code>를 선택하며 기본값은 768P입니다. 10초 옵션은 768P에서만 사용할 수 있습니다.
텍스트-투-비디오 비율
텍스트-투-비디오 요청에는 선택적 <code>ratio</code> 필드를 사용합니다. 이를 첫 프레임 이미지 재정의로 사용해서는 안 됩니다.
비동기 완료
제출이 성공하면 <code>img_uuid</code>가 반환됩니다. 상태 업데이트를 위해 <code>GET /api/v1/jobs/detail</code>을 폴링하거나 <code>custom_callback_url</code>을 제공합니다.
GoEnhance는 비디오별 요금을 토큰당 $0.02로 안내합니다. 제출 전에 유효한 해상도-재생 시간 조합을 선택합니다.
Hailuo 2.3 API 요금
768P, 6초 — 18.2 토큰 ($0.364)
이것은 전체 비디오 요청에 대해 명시된 Hailuo 2.3 API 가격 중 가장 낮은 가격입니다.
768P, 10초 — 36.4 토큰 ($0.728)
애플리케이션이 768P에서 지원되는 더 긴 재생 시간을 필요로 하는 경우 이 등급을 사용합니다.
1080P, 6초 — 31.85 토큰 ($0.637)
Hailuo 2.3은 6초 1080P를 지원하며, 10초 1080P 요청은 지원되지 않습니다.
Hailuo 2.3 API 통합
1
1. 키를 생성하고 요청을 작성합니다
API 키를 생성하여 서버에 보관하고 bearer 인증을 전송합니다.
model: hailuo_2_3, 프롬프트 및 유효한 재생 시간과 해상도를 포함하여 https://api.goenhance.ai/api/v1/videos/generations에 POST합니다. 2
2. 반환된 img_uuid를 저장합니다
제출과 생성은 별도의 단계로 취급하십시오. 반환된
img_uuid를 자체 작업 레코드와 함께 저장하여 재시도 및 사용자 세션에서 작업 식별자를 잃지 않도록 하십시오. 3
3. 폴링 또는 콜백 처리
GET /api/v1/jobs/detail를 폴링하거나 공개 HTTPS 콜백 URL을 제공하십시오. GoEnhance는 상태 변경을 게시하며, 200이 아닌 콜백은 시도당 3초 타임아웃으로 최대 3회 재시도합니다.수동 편집기보다 반복 제출과 비동기 전달이 더 중요한 경우 API를 사용하십시오.
개발자들이 Hailuo 2.3로 구축하는 것
자동화된 광고 콘셉트
승인된 캠페인 프롬프트를 숏 비디오 후보로 변환하고, 완료된 각 에셋을 검토 큐로 라우팅하십시오.
제품 이미지 애니메이션
제품 정지 이미지를 첫 프레임으로 사용하여 카탈로그, 출시 또는 프레젠테이션 워크플로에 적합한 모션 레디 클립을 생성하십시오.
에디토리얼 및 소셜 파이프라인
구조화된 프롬프트, 비동기 작업 추적, 콜백, 모더레이션 및 스토리지를 연결하여 반복 가능한 숏폼 제작을 지원하십시오.
모델 입력, Hailuo 2.3 API 가격, 비동기 작업, 콜백 및 MiniMax API 포지셔닝에 대한 답변입니다.