MPS APILast Updated 2026-09-05 19:20:18

Nano Banana

On this page

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

기본 정보

항목	값
ModelName	`GEM`
ModelVersion	`3.1` / `3.1-lite` / `3.0` / `2.5`
가드레일 해제 지원	미지원

버전별 지원 규격

버전	출력 규격	입력 및 조건
`3.1 참조`	지원 규격: 최대 `14장`	—
`해상도`	지원 규격: `1K` / `2K` / `4K`	—
`비율`	지원 규격: `1:1` / `16:9` / `9:16` / `4:3` / `3:4`; 추가 비율은 버전별 확인	—

참조 이미지를 많이 받는 편집형 생성 엔진입니다. 3.1은 참조 이미지를 최대 14장까지 입력할 수 있습니다.

요청 파라미터

파라미터	필수	타입	설명
`ModelName`	필수	String	고정값 `GEM`
`ModelVersion`	선택	String	`3.1` / `3.1-lite` / `3.0` / `2.5`
`Prompt`	필수	String	생성 프롬프트. 최대 `1000`자
`EnhancePrompt`	선택	Boolean	프롬프트 자동 보정. 기본값 `false`
`ImageInfos.N`	선택	Array	참조 이미지 배열. image-to-image 및 참조 생성에 사용
`ExtraParameters`	선택	Object	`Resolution` / `AspectRatio` 등 출력 옵션
`AdditionalParameters`	선택	String	모델 전용 옵션을 담은 JSON 문자열. `seed` 전달 형식은 추가 설정 참조

요청 예시

LANGUAGE
{
  "ModelName": "GEM",
  "ModelVersion": "3.1",
  "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": "GEM",
  "ModelVersion": "3.1",
  "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>"
  }
}