Happyhorse
On this page
Endpoint: POST https://mps.intl.tencentcloudapi.com
Action: 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을 사용합니다.
LANGUAGE
{
"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/"
}
}응답 예시
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>"
}
}특수 설정
가드레일 해제
입력과 출력 심사를 각각 설정할 수 있습니다.
가드레일 해제 파라미터를 사용하려면 먼저 영업담당자에게 연락해 사용 권한을 확인해야 합니다. 지원 엔진에서도 해당 파라미터를 명시적으로 전달하는 경우에만 가드레일 해제가 적용됩니다. 파라미터를 생략하면 해제되지 않습니다.
| 파라미터 | 해제 값 | 적용 대상 |
|---|---|---|
ExtraParameters.EnablelnputComplianceCheck |
false |
입력 심사 해제 |
ExtraParameters.EnableOutputComplianceCheck |
false |
출력 심사 해제 |
다음 설정을 기존 생성 요청에 병합합니다. 입력과 출력 심사를 모두 해제하려면 두 필드를 함께 전달합니다.
LANGUAGE
{
"ExtraParameters": {
"EnablelnputComplianceCheck": false,
"EnableOutputComplianceCheck": false
}
}