Hailuo

Endpoint: POST https://mps.intl.tencentcloudapi.comAction: CreateAigcVideoTask

기본 정보

항목	값
ModelName	`Hailuo`
ModelVersion	`H3` / `2.3` / `2.3-fast` / `02`
가드레일 해제 지원	`H3`만 지원

버전별 지원 규격

버전	해상도	비율	길이
`H3`	기본 출력: `768P` 업스케일 출력: `1080P` / `2K` / `4K`	`21:9` / `16:9` / `4:3` / `1:1` / `3:4` / `9:16`	`4–15초`
`H3-Max`	기본 출력: `480P` / `768P` 업스케일 출력: `1080P` / `2K` / `4K`	`16:9` / `9:16` / `4:3` / `3:4` / `1:1` / adaptive	`5–15초`
`02` / `2.3`	버전별 출력 옵션 참조	—	`6초` `10초`

입력 조건

버전	조건
`H3`	입력: 참조 이미지 `9장` / 영상 `3개` / 오디오 `3개`, 합계 `12개`; 첫/끝 프레임 모드와 분리
`H3-Max`	입력: 텍스트 또는 첫/끝 프레임
`02` / `2.3`	입력: H3 멀티모달 제한을 적용하지 않음

02와 2.3 계열은 길이가 고정된 단순 생성 엔진이고, H3는 이미지, 영상, 오디오를 함께 참조하는 멀티모달 엔진입니다.

요청 파라미터

파라미터	필수	타입	설명
`ModelName`	필수	String	고정값 `Hailuo`
`ModelVersion`	선택	String	`H3` / `2.3` / `2.3-fast` / `02`
`Prompt`	필수	String	생성 프롬프트. 아래 버전별 제한 참조
`NegativePrompt`	선택	String	결과에서 제외할 요소. 지원 모델에서 적용
`EnhancePrompt`	선택	Boolean	프롬프트 자동 보정. 기본값 `false`
`ImageUrl`	선택	String	첫 프레임 이미지 URL. 외부 접근 가능해야 하고 `10MB` 이하
`LastImageUrl`	선택	String	끝 프레임 이미지 URL. `ImageUrl`과 함께 사용
`ImageInfos.N`	선택	Array	참조 이미지 배열. `Category` / `Url` / `ReferenceType` 등
`Duration`	선택	Integer	생성 길이(초). 모델별 허용값만 반영
`ExtraParameters`	선택	Object	`Resolution` / `AspectRatio` / `EnableAudio`
`AdditionalParameters`	선택	String	모델 전용 옵션을 담은 JSON 문자열. `seed` 전달 형식은 추가 설정 참조
`ExtraParameters.` `EnablelnputComplianceCheck`	선택	Boolean	`false`를 명시적으로 전달하면 입력 심사 해제. 사용 전 영업담당자 문의
`ExtraParameters.` `EnableOutputComplianceCheck`	선택	Boolean	`false`를 명시적으로 전달하면 출력 심사 해제. 사용 전 영업담당자 문의

요청 예시

text-to-video (H3)

H3는 프롬프트의 카메라 움직임을 반영합니다. 기본 출력 해상도는 2560x1440입니다.

json

{
  "ModelName": "Hailuo",
  "ModelVersion": "H3",
  "Prompt": "a girl running toward the camera on a playground holding a kite, orbit camera, cinematic quality",
  "Operator": "wiki-example",
  "StoreCosParam": {
    "CosBucketName": "<bucket-appid>",
    "CosBucketRegion": "<bucket-region>",
    "CosBucketPath": "/aigc/"
  },
  "EnhancePrompt": false
}

H3-Max / 첫/끝 프레임

json

{
  "ModelName": "Hailuo",
  "ModelVersion": "H3-Max",
  "Prompt": "The camera moves from the first frame toward the final composition.",
  "NegativePrompt": "blur, distortion",
  "EnhancePrompt": false,
  "ImageUrl": "https://<host>/first.jpg",
  "LastImageUrl": "https://<host>/last.jpg",
  "Duration": 5,
  "ExtraParameters": {
    "Resolution": "768P",
    "AspectRatio": "16:9"
  },
  "StoreCosParam": {
    "CosBucketName": "<bucket-appid>",
    "CosBucketRegion": "<bucket-region>",
    "CosBucketPath": "/aigc/"
  },
  "Operator": "wiki-example"
}

응답 예시

json

{
  "Response": {
    "Status": "DONE",
    "Message": "ok",
    "Resolution": "1920x1080",
    "VideoUrls": [
      "https://aigc-output-video-<id>.cos.<region>.myqcloud.com/<file>.mp4?q-sign-algorithm=sha1&..."
    ],
    "RequestId": "<request-id>"
  }
}

특수 설정

가드레일 해제

Hailuo는 ModelVersion=H3에서만 가드레일 해제를 지원합니다. 다른 버전에 동일하게 적용하지 마세요.

가드레일 해제 파라미터를 사용하려면 먼저 영업담당자에게 연락해 사용 권한을 확인해야 합니다. 지원 엔진에서도 해당 파라미터를 명시적으로 전달하는 경우에만 가드레일 해제가 적용됩니다. 파라미터를 생략하면 해제되지 않습니다.

파라미터	해제 값	적용 대상
`ExtraParameters.EnablelnputComplianceCheck`	`false`	입력 심사 해제
`ExtraParameters.EnableOutputComplianceCheck`	`false`	출력 심사 해제

다음 설정을 기존 생성 요청에 병합합니다. 입력과 출력 심사를 모두 해제하려면 두 필드를 함께 전달합니다.

json

{
  "ExtraParameters": {
    "EnablelnputComplianceCheck": false,
    "EnableOutputComplianceCheck": false
  }
}

버전별 지원 능력

버전	생성 모드	길이	비고
`H3`	text / image / 멀티모달 참조	`4~15초`	이미지 `9개`, 영상 `3개`, 오디오 `3개` 참조. 음성 네이티브 생성
`2.3`	text / image	`6초`, `10초`	`1080P`는 `6초`만
`2.3-fast`	image 전용	`6초`, `10초`	첫 프레임 필수
`02`	text / image, 첫+끝 프레임	`6초`, `10초`	`16:9`만

H3 입력 제약

이미지 입력 (첫 프레임, 끝 프레임, 참조 이미지)

항목	제약
포맷	JPG, JPEG, PNG, WEBP, HEIC, HEIF
파일 크기	`30MB` 이하
가로 세로 범위	`256~5760 px`
가로 세로 비율	`0.4~2.5`
개수	첫 프레임 `1장`, 끝 프레임 `1장`, 참조 이미지 `9장` 이하

영상 입력 (참조 생성)

항목	제약
컨테이너	MP4, MOV
코덱	영상 H.264, H.265 / 음성 AAC, MP3
파일 크기	`50MB` 이하
개수	`3개` 이하
세그먼트 길이	`2~15초`, 합계 `15초` 이하
가로 세로 범위	`256~5760 px`
가로 세로 비율	`0.4~2.5`
프레임레이트	`23.976~60`

오디오 입력 (참조 생성)

항목	제약
포맷	WAV, MP3
파일 크기	`15MB` 이하
개수	`3개` 이하
세그먼트 길이	`2~15초`, 합계 `15초` 이하

image-to-video (첫 / 끝 프레임)

ImageUrl과 LastImageUrl을 각각 1장씩 입력합니다. 첫/끝 프레임(i2va)과 멀티모달 참조(r2va)는 별도 생성 모드로 선택합니다.

json

{
  "ModelName": "Hailuo",
  "ModelVersion": "H3",
  "Prompt": "camera slowly pushes in",
  "ImageUrl": "https://<cdn>/first.jpg",
  "LastImageUrl": "https://<cdn>/last.jpg",
  "Duration": 6,
  "ExtraParameters": {
    "Resolution": "1080P",
    "AspectRatio": "9:16"
  },
  "Operator": "admin",
  "StoreCosParam": {
    "CosBucketName": "<bucket-appid>",
    "CosBucketRegion": "<bucket-region>",
    "CosBucketPath": "/aigc/"
  },
  "EnhancePrompt": false
}

추가 옵션

i2va와 r2va는 상호 배타

참조 영상 / 오디오 생성은 r2va, 첫/끝 프레임 생성은 i2va 모드를 선택합니다.

Hailuo ​

기본 정보 ​

버전별 지원 규격 ​

입력 조건 ​

요청 파라미터 ​

요청 예시 ​

text-to-video (H3) ​

H3-Max / 첫/끝 프레임 ​

응답 예시 ​

특수 설정 ​

가드레일 해제 ​

버전별 지원 능력 ​

H3 입력 제약 ​

image-to-video (첫 / 끝 프레임) ​

추가 옵션 ​

Hailuo

기본 정보

버전별 지원 규격

입력 조건

요청 파라미터

요청 예시

text-to-video (H3)

H3-Max / 첫/끝 프레임

응답 예시

특수 설정

가드레일 해제

버전별 지원 능력

H3 입력 제약

image-to-video (첫 / 끝 프레임)

추가 옵션