이미지 생성.
본문
modelstring필수- IMAGE 카테고리 모델 ID
promptstring필수- 1~4000자
ninteger선택- 생성할 이미지 수 1~10 (기본 1)
sizestring선택256x256·512x512·1024x1024·1792x1024·1024x1792·1536x1024·1024x1536·autoqualitystring선택standard·hd·low·medium·high·auto— 모델별 지원값과 생략 기본값은 아래 표 참고response_formatstring선택url(기본) ·b64_jsonuserstring선택- 최종 사용자 식별자
모델별로 n 상한이 더 낮을 수 있습니다(Imagen 주의사항 참고).
사용 가능한 이미지 모델은 GET /v1/models 에서 category 가 IMAGE 인 항목을 확인하세요.
모델별 크기·품질·개수
GET /v1/models의 capabilities.image_generation, limits.max_images, limits.supported_sizes, limits.supported_qualities를 확인하세요. 필드 생략은 지원 미확인입니다. 공통 스키마에 있는 값이라도 모델이 지원하지 않으면 400입니다.
| 모델 | 지원값과 의미 |
|---|---|
| Gemini 네이티브 이미지 | n: 1만 지원. quality를 명시하면 400입니다. auto/생략은 공급자 기본값, 1024x1024는 1:1, 1536x1024는 3:2, 1024x1536은 2:3, 1792x1024는 16:9, 1024x1792는 9:16 비율입니다. 정확한 픽셀 크기를 보장하는 값이 아닙니다 |
| Gemini 3 이미지 | 위 비율은 기본 1K 해상도로 요청합니다. 512x512는 Gemini 3.1 Flash Image에서만 지원하며 256x256은 미지원입니다. Gemini 3.1 Flash-Lite Image는 1K만 지원합니다 |
| Gemini 2.5 이미지 | 공급자의 고정 네이티브 해상도를 사용합니다. 256x256·512x512는 미지원입니다 |
| Imagen | 일반 생성은 n: 1~4, upscale은 편집 엔드포인트에서 1입니다. quality는 400입니다. 크기는 픽셀 보장이 아닌 비율 별칭입니다: 정사각형 3종은 1:1, 1536x1024는 4:3, 1024x1536은 3:4, 1792x1024는 16:9, 1024x1792는 9:16 |
| OpenAI GPT Image | low·medium·high·auto 품질 지원. standard→medium, hd→high는 호환 별칭입니다. quality를 생략하면 기존 기본값 medium을 사용합니다. 크기는 1024x1024·1536x1024·1024x1536·auto만 지원하며 생략 시 1024x1024입니다. 256x256·512x512는 400이며 확대 보정되지 않습니다 |
| Meta 이미지 | quality를 명시하면 400입니다 |
반환값
url 은 10분 유효한 presigned URL 입니다. 오래 보관하려면 직접 내려받아 저장하세요.
만료된 뒤에는 GET /v1/outputs/{requestId} 로 24시간 안에 다시 발급받을 수 있습니다.