Happyhorse

Endpoint: POST https://mps.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	생성 프롬프트. 최대 2000자
ImageUrl	선택	String	첫 프레임 이미지 URL. 외부 접근 가능해야 하고 10MB 이하
LastImageUrl	선택	String	끝 프레임 이미지 URL. ImageUrl과 함께 사용
ImageInfos.N	선택	Array	참조 이미지 배열. Category / Url / ReferenceType 등
VideoInfos.N	선택	Array	참조 영상 배열. 1.0에서만 동작
Duration	선택	Integer	생성 길이(초). 모델별 허용값만 반영
ExtraParameters	선택	Object	Resolution / AspectRatio / EnableAudio
AdditionalParameters	선택	String	모델 전용 옵션을 담은 JSON 문자열. seed 전달 형식은 추가 설정 참조
ExtraParameters. EnablelnputComplianceCheck	선택	Boolean	false를 명시적으로 전달하면 입력 심사 해제. 사용 전 영업담당자 문의
ExtraParameters. EnableOutputComplianceCheck	선택	Boolean	false를 명시적으로 전달하면 출력 심사 해제. 사용 전 영업담당자 문의

요청 예시

참조 생성

참조 영상 생성은 ModelVersion=1.0을 사용합니다.

{
  "ModelName": "H2",
  "ModelVersion": "1.0",
  "Prompt": "<<<image_1>>> dances in the rain",
  "ImageInfos": [
    {
      "Category": "Image",
      "Url": "https://<cdn>/ref1.png"
    }
  ],
  "Duration": 5,
  "Operator": "admin",
  "StoreCosParam": {
    "CosBucketName": "<bucket-appid>",
    "CosBucketRegion": "<bucket-region>",
    "CosBucketPath": "/aigc/"
  }
}

응답 예시

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

특수 설정

가드레일 해제

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

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

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

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

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