Hy
On this page
Endpoint: POST https://mps.intl.tencentcloudapi.com
Action: CreateAigcVideoTask
기본 정보
| 항목 | 값 |
|---|---|
| ModelName | Hunyuan |
| ModelVersion | 1.5 |
| 가드레일 해제 지원 | 미지원 |
text-to-video와 image-to-video를 지원하는 기본 엔진입니다. 첫 프레임과 끝 프레임을 함께 지정할 수 있습니다.
요청 파라미터
| 파라미터 | 필수 | 타입 | 설명 |
|---|---|---|---|
ModelName |
필수 | String | 고정값 Hunyuan |
ModelVersion |
선택 | String | 1.5 |
Prompt |
필수 | String | 생성 프롬프트. 텍스트 입력 모드는 최대 2000자로 작성 |
NegativePrompt |
선택 | String | 결과에서 제외할 요소. 지원 모델에서 적용 |
EnhancePrompt |
선택 | Boolean | 프롬프트 자동 보정. 기본값 false |
ImageUrl |
선택 | String | 첫 프레임 이미지 URL. 외부 접근 가능해야 하고 10MB 이하 |
LastImageUrl |
선택 | String | 끝 프레임 이미지 URL. ImageUrl과 함께 사용 |
ImageInfos.N |
선택 | Array | 참조 이미지 배열. Category / Url / ReferenceType 등 |
Duration |
선택 | Integer | 생성 길이(초). 모델별 허용값만 반영 |
ExtraParameters |
선택 | Object | Resolution / AspectRatio / EnableAudio |
AdditionalParameters |
선택 | String | 모델 전용 옵션을 담은 JSON 문자열. seed 전달 형식은 추가 설정 참조 |
요청 예시
image-to-video (첫 / 끝 프레임)
LANGUAGE
{
"ModelName": "Hunyuan",
"ModelVersion": "1.5",
"Prompt": "move the picture",
"NegativePrompt": "top lighting, oversaturated colors",
"EnhancePrompt": false,
"ImageUrl": "https://<cdn>/first.png",
"LastImageUrl": "https://<cdn>/last.png",
"Duration": 5,
"ExtraParameters": {
"Resolution": "720P",
"AspectRatio": "16:9",
"EnableAudio": true
},
"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>"
}
}