Moonheart Docs

简体中文

English
ไทย

简体中文

English
ไทย

主题

Hailuo ​

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

기본 정보 ​

항목값
ModelNameHailuo
ModelVersionH3 / 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:164–15초
H3-Max기본 출력: 480P / 768P
업스케일 출력: 1080P / 2K / 4K		16:9 / 9:16 / 4:3 / 3:4 / 1:1 / adaptive5–15초
02 / 2.3버전별 출력 옵션 참조—6초
10초

입력 조건 ​

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

요청 파라미터 ​

파라미터필수타입설명
ModelName필수String고정값 Hailuo
ModelVersion선택StringH3 / 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선택String16:9 / 9:16 / 1:1 등
OutputConfig.
InputComplianceCheck		선택StringDisabled를 명시적으로 전달하면 입력 심사 해제. 사용 전 영업담당자 문의
OutputConfig.
OutputComplianceCheck		선택StringDisabled를 명시적으로 전달하면 출력 심사 해제. 사용 전 영업담당자 문의

요청 예시 ​

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

응답 예시 ​

json
{
  "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.InputComplianceCheckDisabled입력 심사 해제
OutputConfig.OutputComplianceCheckDisabled출력 심사 해제

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

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

H3와 H3-Max 비교 ​

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

참조 생성 모델 선택

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

첫/끝 프레임 (H3) ​

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

json
{
  "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개
json
{
  "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
json
{
  "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초입니다.

基于 VitePress 构建 · 部署于腾讯云 EdgeOne Pages

© 2026 Moonheart