빠른 답변
- Supports prompt-based image generation with multiple aspect ratios.
- Supports reference_images for stronger style consistency.
- Official variants expose richer generation controls for production tuning.
주요 파라미터
- model | string | 필수 | gemini-3-pro-image-official | - | Exact image model identifier from ToAPIs.
- prompt | string | 필수 | - | - | Primary image instruction prompt.
- size | string | 선택 | 1:1 | 1:1 | 16:9 | 9:16 | 4:3 | 3:4 | 21:9 | Output aspect ratio.
- resolution | string | 선택 | 1K | 1K | 2K | 4K(按模型能力) | Output resolution, varies by model variant.
- reference_images | file[] | 선택 | - | max 14 | Reference image array for style/composition control.
- temperature | number | 선택 | 0.8 | 0-2 | Sampling temperature for diversity control.
- topP | number | 선택 | 0.95 | 0-1 | Nucleus sampling threshold.
자주 발생하는 오류
- 400 invalid_request_error: 발생 조건=Missing or invalid request payload fields.; 해결=Validate model/prompt/size/resolution fields.; 재시도=Retry only after fixing payload.
- 401 authentication_error: 발생 조건=Missing or invalid API key.; 해결=Verify Authorization header and API key scope.; 재시도=Retry after auth fix.
- 429 rate_limit_exceeded: 발생 조건=Request rate, concurrency, or current quota hits upstream rate limiting.; 해결=Apply exponential backoff first, then review request rate, concurrency, and quota usage.; 재시도=Use 1s/2s/4s backoff with jitter; if it persists, reduce submission pressure.







