WAND wiki
최근 문서

검색 결과가 없습니다. 모델명이나 다른 키워드로 검색해 보세요.

↑ ↓ 이동 ↵ 열기전체 결과 보기 →
MPS APILast Updated 2026-09-30

Hailuo

On this page

Endpoint: POST https://mps.intl.tencentcloudapi.com
Action: 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입니다.

LANGUAGE
{
  "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 / 첫/끝 프레임

LANGUAGE
{
  "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"
}

응답 예시

LANGUAGE
{
  "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 출력 심사 해제

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

LANGUAGE
{
  "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)는 별도 생성 모드로 선택합니다.

LANGUAGE
{
  "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 모드를 선택합니다.

Contact us about WAND