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