Happyhorse

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

기본 정보

항목	값
ModelName	H2
ModelVersion	1.1 / 1.0
기본값	ModelVersion=1.1 / Resolution=1080P
가드레일 해제 지원	지원

버전별 지원 규격

버전	해상도	비율	길이
1.1	720P / 1080P / 2K / 4K	16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 4:5 / 5:4 / 9:21 / 21:9	3~15초, 기본 5초
1.0	720P / 1080P / 2K / 4K	16:9 / 9:16 / 1:1 / 3:4 / 4:3	3~15초, 기본 5초

입력 조건

텍스트 생성, 첫 프레임 이미지, 참조 이미지 1~9장을 지원합니다. 영상 참조는 1.0에서 지원합니다.

요청 파라미터

파라미터	필수	타입	설명
ModelName	필수	String	고정값 H2
ModelVersion	선택	String	1.1 / 1.0
Prompt	필수	String	생성 프롬프트
FileInfos.N	선택	Array	참조 입력. Usage는 FirstFrame(첫 프레임) 또는 Reference(참조)
OutputConfig.Resolution	선택	String	720P / 1080P / 2K / 4K
OutputConfig.Duration	선택	Integer	영상 길이(초)
OutputConfig.AspectRatio	선택	String	16:9 / 9:16 / 1:1 등
OutputConfig. InputComplianceCheck	선택	String	Disabled를 명시적으로 전달하면 입력 심사 해제. 사용 전 영업담당자 문의
OutputConfig. OutputComplianceCheck	선택	String	Disabled를 명시적으로 전달하면 출력 심사 해제. 사용 전 영업담당자 문의

요청 예시

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

응답 예시

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

특수 설정

가드레일 해제

입력과 출력 심사를 각각 설정할 수 있습니다.

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

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

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

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