WAND wiki
최근 문서

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

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

Hailuo

On this page

Endpoint: POST https://vod.intl.tencentcloudapi.com
Action: CreateAigcVideoTask

기본 정보

항목 값
ModelName Hailuo
ModelVersion H3 / H3-Max / H3_regen / 2.3 / 2.3-fast / 02
기본값 ModelVersion=H3 / Resolution=1080P
가드레일 해제 지원 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 멀티모달 제한을 적용하지 않음

요청 파라미터

파라미터 필수 타입 설명
ModelName 필수 String 고정값 Hailuo
ModelVersion 선택 String H3 / H3-Max / H3_regen / 2.3 / 2.3-fast / 02
Prompt 필수 String 생성 프롬프트
FileInfos.N 선택 Array 참조 입력. Usage는 FirstFrame(첫 프레임) 또는 Reference(참조)
OutputConfig.Resolution 선택 String 버전별 규격 참조
OutputConfig.Duration 선택 Integer 영상 길이(초)
OutputConfig.AspectRatio 선택 String 16:9 / 9:16 / 1:1 등
OutputConfig.
InputComplianceCheck		 선택 String Disabled를 명시적으로 전달하면 입력 심사 해제. 사용 전 영업담당자 문의
OutputConfig.
OutputComplianceCheck		 선택 String Disabled를 명시적으로 전달하면 출력 심사 해제. 사용 전 영업담당자 문의

요청 예시

LANGUAGE
{
  "SubAppId": 123456789,
  "ModelName": "Hailuo",
  "ModelVersion": "H3",
  "Prompt": "a calm sunset over the ocean, cinematic",
  "OutputConfig": {
    "Resolution": "1080P",
    "Duration": 5,
    "AspectRatio": "16:9",
    "StorageMode": "Temporary"
  },
  "SessionContext": "job-001"
}

응답 예시

LANGUAGE
{
  "AigcVideoTask": {
    "Status": "FINISH",
    "ErrCode": 0,
    "Progress": 100,
    "Output": {
      "FileInfos": [
        {
          "FileUrl": "http://<host>.vod2.myqcloud.com/.../aigcVideoGenFile.mp4",
          "ExpireTime": "2026-08-01T10:29:48Z",
          "MetaData": {
            "Width": 1920,
            "Height": 1080,
            "Duration": 5.07,
            "Container": "mov,mp4,m4a",
            "Bitrate": 9494850
          }
        }
      ]
    }
  }
}

특수 설정

가드레일 해제

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

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

파라미터 해제 값 적용 대상
OutputConfig.InputComplianceCheck Disabled 입력 심사 해제
OutputConfig.OutputComplianceCheck Disabled 출력 심사 해제

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

LANGUAGE
{
  "OutputConfig": {
    "InputComplianceCheck": "Disabled",
    "OutputComplianceCheck": "Disabled"
  }
}

H3와 H3-Max 비교

항목 H3 H3-Max
텍스트 투 영상 지원 지원
첫/끝 프레임 지원 지원
멀티모달 참조 이미지, 영상, 오디오 —
영상 길이 4~15초 5~15초
해상도 768P / 1080P / 2K / 4K 768P / 1080P / 2K / 4K
프롬프트 길이 최대 7000자 최대 7000자

참조 생성 모델 선택

멀티모달 참조 생성은 H3를 사용합니다.

첫/끝 프레임 (H3)

FileInfos.N.Usage로 FirstFrame / LastFrame을 지정합니다. 이미지는 0장, 1장, 2장 중 선택이며 가로세로는 [256, 5760] 범위, 비율은 5:2 ~ 2:5 사이여야 합니다. 이미지가 없으면 텍스트 투 영상로 동작합니다.

LANGUAGE
{
  "SubAppId": 123456789,
  "ModelName": "Hailuo",
  "ModelVersion": "H3",
  "FileInfos": [
    {
      "Type": "Url",
      "Category": "Image",
      "Url": "https://<cos>/first.png",
      "Usage": "FirstFrame"
    },
    {
      "Type": "Url",
      "Category": "Image",
      "Url": "https://<cos>/last.jpg",
      "Usage": "LastFrame"
    }
  ],
  "Prompt": "she opens the window, looks into the distance, then runs out of the castle and rides away",
  "OutputConfig": {
    "Duration": 10,
    "Resolution": "2K",
    "AspectRatio": "9:16",
    "AudioGeneration": "Enabled",
    "StorageMode": "Permanent"
  },
  "SessionContext": "job-001"
}

이미지 투 영상의 종횡비는 입력 이미지를 따릅니다

이미지 입력 모드의 출력 종횡비는 입력 이미지 비율을 따릅니다.

멀티모달 참조 (H3)

이미지, 영상, 오디오를 함께 참조로 지정합니다. 오디오만 단독으로 넣을 수는 없고 반드시 이미지나 영상과 함께 넣어야 합니다.

입력 제한
이미지 최대 9장. 가로세로 [256, 5760]
영상 최대 3개. 개별 2~15초, 전체 15초 이하. 가로세로 [256, 5760], 비율 5:2 ~ 2:5
오디오 최대 3개. 개별 2~15초, 전체 15초 이하. 이미지 또는 영상과 함께 입력해야 함
전체 파일 합산 최대 12개
LANGUAGE
{
  "SubAppId": 123456789,
  "ModelName": "Hailuo",
  "ModelVersion": "H3",
  "FileInfos": [
    {
      "Type": "Url",
      "Category": "Image",
      "Url": "https://<cos>/ref1.png",
      "Usage": "Reference"
    },
    {
      "Type": "Url",
      "Category": "Image",
      "Url": "https://<cos>/ref2.jpg",
      "Usage": "Reference"
    },
    {
      "Type": "Url",
      "Category": "Video",
      "Url": "https://<cos>/ref3.mp4",
      "Usage": "Reference"
    }
  ],
  "Prompt": "the figure in image 1 takes the hand of the figure in image 2 and runs out onto the meadow",
  "EnhancePrompt": "Enabled",
  "OutputConfig": {
    "Resolution": "2K",
    "AspectRatio": "9:16",
    "StorageMode": "Temporary"
  },
  "SessionContext": "job-001"
}

첫/끝 프레임과 참조 모드

첫/끝 프레임(FirstFrame / LastFrame) 또는 참조(Reference) 중 한 모드를 선택합니다.

영상 재생성 (H3_regen)

이미 만든 영상을 기준으로 다시 생성합니다. ModelVersion=H3_regen을 쓰고, 기준이 되는 태스크 ID를 ExtInfo로 전달하거나 소스 영상을 직접 지정합니다.

방식 지정 방법
태스크 ID 기준 ExtInfo.AdditionalParameters.RegenSourceTaskId에 이전 태스크 ID
소스 영상 기준 FileInfos에 Category=Video / ReferenceType=base_video
LANGUAGE
{
  "SubAppId": 123456789,
  "ModelName": "Hailuo",
  "ModelVersion": "H3_regen",
  "Prompt": "she turns her head, opens the window and looks into the distance, then smiles",
  "OutputConfig": {
    "StorageMode": "Temporary",
    "Resolution": "2K"
  },
  "ExtInfo": "{\"AdditionalParameters\": \"{\\\"RegenSourceTaskId\\\": \\\"<previous-task-id>\\\"}\"}",
  "SessionContext": "job-001"
}

소스 영상 규격

소스 영상을 아래 규격에 맞춰 준비하고 DescribeTaskDetail로 처리 결과를 확인합니다.

항목 조건
오디오 트랙 필수
해상도 가로와 세로가 모두 32의 배수
프레임 수 107 + 17 × n (n = 0~15)

107 + 17 × n 은 107 / 124 / 141 부터 362 까지 16개 값이며, 24fps 기준 약 4.5초에서 15초 구간에 해당합니다.

소스 영상의 해상도

1280x704 / 1920x1088 / 2560x1440 처럼 가로와 세로가 모두 32의 배수인 규격을 사용하세요.

재생성은 24시간 이내 태스크만 가능합니다

RegenSourceTaskId는 생성 후 24시간 이내의 태스크를 지정합니다.

입력 규격

항목 제한
영상 파일 개별 50MB 이하
이미지 파일 개별 30MB 이하
오디오 파일 개별 15MB 이하

파일 크기는 개별 파일 기준으로 적용합니다.

추가 옵션

H3 네이티브 멀티모달

H3는 참조 이미지 최대 9장 / 영상 3개 / 오디오 3개 또는 첫/끝 프레임 각 1장을 입력합니다. 종횡비 지정과 음성 동시 생성을 지원합니다. 02/2.3은 6초 / 10초, H3는 4~15초입니다.

Contact us about WAND