Image2

Endpoint: POST https://mps.intl.tencentcloudapi.comAction: 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"}

요청 예시

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

참조 이미지 요청

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

응답 예시

{
  "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"}로 자동 결정도 가능합니다.

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