Hy

Endpoint: POST https://mps.intl.tencentcloudapi.comAction: CreateAigcImageTask

기본 정보

항목	값
ModelName	Hunyuan
ModelVersion	3.5-preview / 3.0
가드레일 해제 지원	미지원

Hy Image에는 입력·출력 가드레일 해제 파라미터가 적용되지 않습니다.

텍스트 생성과 참조 이미지 편집을 지원합니다.

3.0은 참조 이미지 3장, 3.5-preview는 6장까지 입력할 수 있습니다.

요청 파라미터

파라미터	필수	타입	설명
ModelName	필수	String	고정값 Hunyuan
ModelVersion	선택	String	3.5-preview / 3.0
Prompt	필수	String	생성 프롬프트. 최대 1000자. 참조 이미지가 있으면 편집 지시문으로 동작
EnhancePrompt	선택	Boolean	프롬프트 자동 보정. 기본값 false
ImageInfos.N	선택	Array	참조 이미지 배열. 각 항목은 ImageUrl 필드를 사용합니다
ExtraParameters	선택	Object	Resolution / AspectRatio 등 출력 옵션
AdditionalParameters	선택	String	픽셀 크기 직접 지정. {"size":"1808x1024"}
OutputImageCount	선택	Integer	최상위 필드. 3.5-preview에서는 1장만 반환됩니다

MPS 출력 설정

해상도와 비율은 ExtraParameters, 출력 장수는 최상위 OutputImageCount에 지정합니다.

요청 예시

{
  "ModelName": "Hunyuan",
  "ModelVersion": "3.5-preview",
  "Prompt": "a serene japanese garden, soft morning light",
  "ExtraParameters": {
    "Resolution": "2K",
    "AspectRatio": "16:9"
  },
  "Operator": "admin",
  "StoreCosParam": {
    "CosBucketName": "<bucket-appid>",
    "CosBucketRegion": "<bucket-region>",
    "CosBucketPath": "/aigc/"
  },
  "EnhancePrompt": false
}

{
  "ModelName": "Hunyuan",
  "ModelVersion": "3.5-preview",
  "Prompt": "change the car color to matte black, keep the composition",
  "ImageInfos": [
    {
      "ImageUrl": "https://<host>/car.png"
    }
  ],
  "ExtraParameters": {
    "Resolution": "1K",
    "AspectRatio": "16:9"
  },
  "Operator": "wiki-example",
  "StoreCosParam": {
    "CosBucketName": "<bucket-appid>",
    "CosBucketRegion": "<bucket-region>",
    "CosBucketPath": "/aigc/"
  },
  "EnhancePrompt": false
}

응답 예시

{
  "Response": {
    "Status": "DONE",
    "Message": "ok",
    "ImageUrls": [
      "https://aigc-output-image-<id>.cos.<region>.myqcloud.com/<file>.png?q-sign-algorithm=sha1&..."
    ],
    "RequestId": "<request-id>"
  }
}

특수 설정

출력 해상도

ExtraParameters.Resolution과 ExtraParameters.AspectRatio 조합에 따른 실제 출력 픽셀입니다. VOD 경로와 동일한 매핑을 사용합니다.

Resolution	1:1	16:9	9:16	4:3	3:4
생략	720x720	1280x720	720x1280	960x720	720x960
1K	1024x1024	1808x1024	1024x1808	1360x1024	1024x1360
2K	2048x2048	2048x1152	1152x2048	1920x1440	1440x1920
4K	4096x4096	3840x2160	2160x3840	3840x2880	2880x3840

Resolution을 생략하고 AspectRatio만 넣으면 짧은 변이 720으로 고정됩니다. 두 값을 모두 생략하면 3:2 비율의 1872x1248로 출력됩니다.

4K / 5:4 조합은 2688x2160으로 출력됩니다.

픽셀 크기 직접 지정

AdditionalParameters에 size를 넣으면 ExtraParameters의 해상도와 비율보다 우선 적용됩니다. 값은 가로x세로 형식이며, VOD 경로와 달리 JSON 이스케이프가 한 단계입니다.

{
  "AdditionalParameters": "{\"size\":\"1808x1024\"}"
}

입력값	실제 출력
1808x1024	1808x1024
1024x1536	1024x1536
656x1000	656x992 (16의 배수로 내림)
auto	프롬프트에 맞춰 자동 결정
100x100	256x256 (하한으로 보정)

참조 이미지

ImageInfos에 참조 이미지의 ImageUrl을 입력합니다.

{
  "ImageInfos": [
    {
      "ImageUrl": "https://<host>/reference.png"
    }
  ]
}

항목	값
필수 필드	ImageUrl
참조 장수	최대 6장
포맷	jpeg, png, webp

참조 이미지 입력

ImageInfos에 ImageUrl을 지정합니다. ReferenceType을 함께 사용할 수 있습니다.