MPS APILast Updated 2026-09-25

Hy

On this page

Endpoint: POST https://mps.intl.tencentcloudapi.com
Action: 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에 지정합니다.

요청 예시

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

응답 예시

LANGUAGE
{
  "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 이스케이프가 한 단계입니다.

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

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

참조 이미지

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

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

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

참조 이미지 입력

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