Skip to main content
We recommend separating the aspect ratio and resolution into two parameters:
You can also pass exact pixel dimensions:
  • Aspect ratios: 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9, 9:21.
  • Resolutions: 1k, 2k, 4k.
  • Defaults: size=1:1, resolution=2k.
  • Expose exact WxH pixels only in an advanced mode.

​
Resolution fields

We recommend using only resolution. The following aliases are also supported:

​
Dimension mapping

When size is an aspect ratio, the service maps it to exact pixel dimensions. Width and height are aligned to 16 pixels. The 4K tier stays within an approximate 3840x2160 pixel budget, so square 4K output is 2880x2880, not 3840x3840.

​
Images per request

The maximum n depends on the resolution tier:

​
Recommendations

  • Use 2k by default for the best balance in most products.
  • 4k takes longer to generate; expose it under advanced options.
  • 1k can generate only one image per request and is suitable for previews or low-cost batches.
  • If users care only about social-media formats, show aspect ratios first instead of asking them to enter pixels.