Per-request billing — This model is billed per request. Token group must be set to Aggregate.
Key capabilities
- Text-to-image — Generate images from text descriptions
- Image editing — Pass a reference image in
inline_dataalongside your text instruction - Aspect ratio control —
1:1,4:3,3:4,16:9,9:16 - Resolution control —
1K(~1024px),2K(~2048px),4K(~4096px) on the long edge - Multi-modal output — Return both the image and a text caption with
responseModalities: ["TEXT", "IMAGE"]
Text-to-image example
Image editing example (with reference image)
Include both atext instruction and an inline_data reference image in the same parts array.
Parameters
API Reference
View the interactive API playground for gemini-3-pro-image-preview-c.