MPS APILast Updated 2026-09-07

Image2

On this page

Endpoint: POST https://mps.intl.tencentcloudapi.com
Action: CreateAigcImageTask

기본 정보

항목	값
ModelName	`OG`
ModelVersion	`image2_` / `image2.5_sunburst_` / `image2.5_flare_*`
가드레일 해제 지원	미지원

버전별 지원 규격

버전	출력 규격	입력 및 조건
공통	해상도: `1K` / `2K` / `4K`; 커스텀 크기는 아래 픽셀 제약 적용 비율: `1:1` / `3:2` / `2:3` / `3:4` / `4:3` / `16:9` / `9:16` / `21:9` / `9:21` image2.5: sunburst / flare 각각 low, medium, high, xhigh, max	참조 이미지: 최대 `16장`

2.0 계열(image2_*)과 2.5 계열(image2.5_sunburst_* / image2.5_flare_*)을 같은 ModelName으로 호출합니다. 품질 단계 선택, 참조 이미지, 커스텀 해상도, 마스크 편집을 지원합니다. 다국어 텍스트 렌더링이 강점입니다.

요청 파라미터

파라미터	필수	타입	설명
`ModelName`	필수	String	고정값 `OG`
`ModelVersion`	선택	String	모델 버전. 생략하면 엔진 기본값
`Prompt`	필수	String	생성 프롬프트. 최대 `1000`자
`EnhancePrompt`	선택	Boolean	프롬프트 자동 보정. 기본값 `false`
`ImageInfos.N`	선택	Array	참조 이미지 배열. `ImageUrl`에 이미지 URL을 넣고, `ReferenceType=mask`로 마스크 편집 지정
`ExtraParameters`	선택	Object	`Resolution` / `AspectRatio` 등 출력 옵션
`AdditionalParameters`	선택	String	모델 전용 옵션을 담은 JSON 문자열. `seed` 전달 형식은 추가 설정 참조. 커스텀 사이즈 `{"size":"2048x2048"}`, 자동 `{"size":"auto"}`, 투명 배경 `{"background":"transparent"}`

요청 예시

LANGUAGE
{
  "ModelName": "OG",
  "ModelVersion": "image2.5_sunburst_medium",
  "Prompt": "a young woman in traditional hanbok standing by a moonlit lake",
  "EnhancePrompt": true,
  "ExtraParameters": {
    "Resolution": "1080P",
    "AspectRatio": "16:9"
  },
  "Operator": "admin",
  "StoreCosParam": {
    "CosBucketName": "<bucket-appid>",
    "CosBucketRegion": "<bucket-region>",
    "CosBucketPath": "/aigc/"
  }
}

참조 이미지 요청

LANGUAGE
{
  "ModelName": "OG",
  "ModelVersion": "image2.5_sunburst_medium",
  "Prompt": "Change the background to a quiet garden; preserve the subject.",
  "EnhancePrompt": true,
  "ExtraParameters": {
    "Resolution": "1080P",
    "AspectRatio": "16:9"
  },
  "Operator": "admin",
  "StoreCosParam": {
    "CosBucketName": "<bucket-appid>",
    "CosBucketRegion": "<bucket-region>",
    "CosBucketPath": "/aigc/"
  },
  "ImageInfos": [
    {
      "ImageUrl": "https://<host>/reference.jpg"
    }
  ]
}

응답 예시

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

특수 설정

모델 버전

2.5 계열의 ModelVersion은 image2.5_{계열}_{단계} 형식입니다. 계열은 sunburst와 flare 두 가지이고, 단계는 다섯 단계입니다.

단계	sunburst	flare
`low`	`image2.5_sunburst_low`	`image2.5_flare_low`
`medium`	`image2.5_sunburst_medium`	`image2.5_flare_medium`
`high`	`image2.5_sunburst_high`	`image2.5_flare_high`
`xhigh`	`image2.5_sunburst_xhigh`	`image2.5_flare_xhigh`
`max`	`image2.5_sunburst_max`	`image2.5_flare_max`

2.0 계열은 image2_low / image2_medium / image2_high를 그대로 사용합니다.

품질 단계

단계가 올라갈수록 정밀도가 높아지고 생성 시간이 길어집니다.

단계	특징	용도
`low`	가장 빠르게 생성	초안, 대량 테스트, 프롬프트 반복 검증
`medium`	속도와 화질의 균형점	일상적인 제작, 범용 디자인
`high`	디테일과 질감, 광원 표현 강화	검토용 결과물, 상세 표현이 필요한 이미지
`xhigh`	`high`보다 높은 정밀도	최종 검토, 확대 사용
`max`	최고 정밀도. 복잡한 문자와 작은 글자 처리에 강함	최종 납품물, 인쇄물, 고정밀 제품 이미지

계열별 생성 시간

같은 프롬프트와 1024x1024 기준으로 측정한 값입니다. 네트워크 상태와 서버 부하에 따라 달라집니다.

계열	`low`	`medium`	`high`	`xhigh`	`max`
`sunburst`	`30초`	`30초`	`53초`	`92초`	`169초`
`flare`	`22초`	`22초`	`35초`	`41초`	`61초`

해상도 규격

항목	제약
커스텀 해상도	가로와 세로가 모두 `16`의 배수
최장변	`3840 px` 이하
총 픽셀	`655,360` 이상 `8,294,400` 이하
프리셋	`1024x1024`(정방), `1536x1024`(가로), `1024x1536`(세로)
고해상도	`2K`(`2560x1440`), `4K`(`3840x2160`). `2560px` 초과는 제한적 지원
출력 포맷	PNG, JPEG, WebP
참조 이미지	이미지 편집, 스타일 전이, 멀티 이미지 합성
배경 투명도	지원. `AdditionalParameters`에 `{"background":"transparent"}` 전달

ExtraParameters.Resolution에 프리셋을 지정하면 비율에 맞춰 해상도가 결정됩니다. 높이는 16의 배수로 보정됩니다.

프리셋	`AspectRatio=16:9` 출력
`1080P`	`1920x1088`
`2K`	`2560x1440`
`4K`	`3840x2160`

커스텀 해상도 생성

AdditionalParameters에 size를 지정합니다. 값은 16의 배수여야 하고 총 픽셀 수는 655,360 이상 8,294,400 이하입니다. {"size":"auto"}로 자동 결정도 가능합니다.

LANGUAGE
{
  "ModelName": "OG",
  "ModelVersion": "image2.5_flare_high",
  "Prompt": "a serene japanese garden, soft morning light",
  "EnhancePrompt": true,
  "AdditionalParameters": "{\"size\":\"1536x1024\"}",
  "Operator": "admin",
  "StoreCosParam": {
    "CosBucketName": "<bucket-appid>",
    "CosBucketRegion": "<bucket-region>",
    "CosBucketPath": "/aigc/"
  }
}