YeeHooDevelopers
Developer Docs
Supported Models and ParametersImage Models

GPT Image 2

Parameters, enums, examples, and integration notes for gpt-image-2.

gpt-image-2 is the best default public image model to start with. It is suitable for flow validation as well as real production use.

Its main strengths are broad coverage and richer ratio / resolution options.

Quick Facts

ItemValue
Model IDgpt-image-2
TypeImage
RegionGlobal / CN
Best ForGeneral image generation, posters, covers, editing
PriorityHigh, best default starting point

Recommended Request Shape

Image tasks still go to POST /v1/generations; only the model value changes.

{
  "model": "gpt-image-2",
  "prompt": "A premium skincare poster on warm marble, soft daylight, luxury editorial style",
  "aspect_ratio": "4:5",
  "resolution": "2K",
  "n": 1
}

Field Reference

FieldTypeRequiredDefaultDescription
modelstringYes-Must be gpt-image-2
promptstringYes-Image prompt
reference_imagesstring[]No-Reference image URL list
aspect_ratiostringNoautoOutput aspect ratio
resolutionstringNo1KOutput resolution
nintegerNo1Image count

Supported Enums

FieldValues
aspect_ratioauto 1:1 5:4 9:16 21:9 16:9 3:2 4:3 4:5 3:4 2:3
resolution1K 2K 4K

gpt-image-2 Integration Notes

  • If you just want to validate create-task, polling, and webhook flows, this is the best first model to test.
  • It supports 5:4 and 4:5, which the Banana models do not.
  • For lower-cost validation, start with resolution=1K.

Smallest Example

{
  "model": "gpt-image-2",
  "prompt": "A premium skincare poster on warm marble"
}

Related Pages