Hy

Endpoint: POST https://mps.intl.tencentcloudapi.comAction: 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 (첫 / 끝 프레임)

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

응답 예시

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