Nano Banana
On this page
Endpoint: POST https://vod.intl.tencentcloudapi.com
Action: CreateAigcImageTask
기본 정보
| 항목 | 값 |
|---|---|
| ModelName | GEM |
| ModelVersion | 3.1 / 3.1-lite / 3.0 / 2.5 |
| 기본값 | ModelVersion=3.1 / AspectRatio=1:1 |
| 가드레일 해제 지원 | 미지원 |
버전별 지원 규격
| 버전 | 출력 규격 | 입력 및 조건 |
|---|---|---|
3.1 참조 |
지원 규격: 최대 14장 |
— |
해상도 |
지원 규격: 1K / 2K / 4K |
— |
비율 |
지원 규격: 1:1 / 16:9 / 9:16 / 4:3 / 3:4; 추가 비율은 버전별 확인 |
— |
요청 파라미터
| 파라미터 | 필수 | 타입 | 설명 |
|---|---|---|---|
ModelName |
필수 | String | 고정값 GEM |
ModelVersion |
선택 | String | 3.1 / 3.1-lite / 3.0 / 2.5 |
Prompt |
필수 | String | 생성 프롬프트 |
FileInfos.N |
선택 | Array | 참조 이미지(image-to-image). Category는 Image |
OutputConfig.AspectRatio |
선택 | String | 1:1 / 16:9 / 9:16 / 4:3 / 3:4 등 |
OutputConfig.OutputImageCount |
선택 | Integer | 생성 장수 (모델별 상한 상이) |
요청 예시
LANGUAGE
{
"SubAppId": 123456789,
"ModelName": "GEM",
"ModelVersion": "3.1",
"Prompt": "a serene japanese garden, soft morning light",
"OutputConfig": {
"AspectRatio": "1:1",
"OutputImageCount": 1,
"StorageMode": "Temporary"
},
"SessionContext": "job-001"
}참조 이미지 요청
LANGUAGE
{
"SubAppId": 123456789,
"ModelName": "GEM",
"ModelVersion": "3.1",
"Prompt": "Change the background to a quiet garden; preserve the subject.",
"OutputConfig": {
"AspectRatio": "1:1",
"OutputImageCount": 1,
"StorageMode": "Temporary"
},
"SessionContext": "job-001",
"FileInfos": [
{
"Type": "Url",
"Category": "Image",
"Url": "https://<host>/reference.jpg"
}
]
}응답 예시
LANGUAGE
{
"AigcImageTask": {
"Status": "FINISH",
"ErrCode": 0,
"Progress": 100,
"Output": {
"FileInfos": [
{
"FileUrl": "http://<host>.vod2.myqcloud.com/.../aigcImageGenFile.png",
"ExpireTime": "2026-08-01T10:29:48Z",
"MetaData": {
"Width": 1024,
"Height": 1024,
"Container": "png"
}
}
]
}
}
}특수 설정
추가 옵션
Google Gemini Image 계열
텍스트→이미지 생성과 참조 이미지 생성(i2i)을 지원합니다.