Skip to main content
POST
HappyHorse 비디오 생성

소개

HappyHorse는 Alibaba Cloud Bailian의 비디오 생성 제품군입니다: 텍스트-투-비디오(HappyHorse-T2V), 이미지-투-비디오(HappyHorse-I2V), 참조-투-비디오(HappyHorse-R2V). 720P1080P에서 물리적으로 사실적이고 부드러운 동작의 비디오를 3~15초 길이로 생성합니다. GravitexAI 통합 비디오 API를 사용하세요: 작업 제출task_id를 받은 후 작업 조회로 상태를 폴링하고 url을 확인합니다.
HappyHorse는 Wan 2.7과 동일한 구조로 metadata.inputmetadata.parameters를 통해 기본 DashScope 매개변수를 전달합니다. 참조-투-비디오는 프롬프트에서 [Image 1], [Image 2](영문 괄호 형식)를 사용하며 이미지 참조만 지원합니다—비디오 참조는 없습니다.

인증

string
필수
Bearer Token, 예: Bearer sk-xxxxxxxxxx

지원 모델

워크플로

  1. 작업 제출: model, prompt, durationmetadata의 HappyHorse 매개변수와 함께 POST /v1/video/generations.
  2. 상태 폴링: statussucceeded 또는 failed가 될 때까지 3~15초마다 GET /v1/video/generations/{task_id}.
  3. 결과 확인: 성공 시 url에 비디오 링크 포함(보통 24시간 유효—즉시 다운로드 권장).

공통 요청 구조

제출 응답

조회 응답(성공)

사용 사례

텍스트 프롬프트에서 물리적으로 사실적이고 부드러운 동작의 비디오를 생성합니다.
string
필수
원하는 비디오를 설명하는 텍스트 프롬프트
string
기본값:"1080P"
720P 또는 1080P
string
기본값:"16:9"
화면 비율: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9
integer
기본값:"5"
길이(초), 범위 3~15
boolean
기본값:"true"
워터마크 추가(우하단 고정 텍스트 “Happy Horse”)
integer
랜덤 시드, 범위 [0, 2147483647], 재현성용
예제:

매개변수 참조

공통 매개변수

텍스트-투-비디오 & 참조-투-비디오

미디어 입력 제한

오류 처리

실패 시 statusfailed이며 error.message에 원인이 포함됩니다.

FAQ

비디오 urltask_id는 보통 24시간 유효합니다. 즉시 다운로드하여 저장하세요.
프롬프트에서 **[Image 1], [Image 2]**를 사용하세요. 순서는 mediareference_image 항목과 일치합니다. 각 참조의 구체적 객체를 설명하세요.
HappyHorse I2V는 첫 프레임(first_frame)만 지원합니다—첫+마지막 프레임, 연속 생성, 오디오 드라이빙은 없습니다.
동일한 metadata.input / metadata.parameters 구조. HappyHorse R2V는 [Image n]과 이미지만 사용(최대 9개); Wan 2.7은 图n/视频n과 비디오 참조 및 보이스 클론을 사용합니다. HappyHorse는 기본 1080P 및 워터마크 켜짐; 길이는 3~15초입니다.

관련 엔드포인트

비디오 작업 제출

통합 비디오 제출 및 다중 모델 매개변수

비디오 작업 조회

작업 상태 폴링 및 비디오 URL 확인