YeeHooDevelopers
Developer Docs
Supported Models and ParametersImage Models

GPT Image 2 Official

Complete parameters, enums, and integration notes for gpt-image-2-official.

gpt-image-2-official is the official GPT Image 2 channel variant for image generation and editing with an explicit quality tier.

Its key difference from gpt-image-2 is the quality field; do not send that field to the standard model.

Quick Facts

ItemValue
Model IDgpt-image-2-official
TypeImage
RegionGlobal
Best ForOfficial image generation with controllable quality
PriorityUse when quality is required

Recommended Request Shape

Submit to POST /v1/generations and choose a quality tier for the target cost and result.

{
  "model": "gpt-image-2-official",
  "prompt": "A premium skincare poster on warm marble, luxury editorial style",
  "quality": "high",
  "resolution": "2K",
  "n": 1
}

Field Reference

FieldTypeRequiredDefaultDescription
modelstringYes-Must be gpt-image-2-official
promptstringYes-Image prompt
reference_imagesstring[]No-Reference image URL list
qualitystringNomediumlow is speed/cost-first, medium is balanced, and high is quality-first; the tier affects cost
resolutionstringNo1KOutput resolution
sizestringNo-Upstream size field
nintegerNo1Image count

Supported Enums

FieldValues
qualitylow (speed/cost-first), medium (default balance), high (quality-first, higher cost)
resolution1K 2K 4K

Integration Notes

  • Start with quality=medium and resolution=1K during integration.
  • quality is official-model-only; remove it when switching to gpt-image-2.
  • Use n for multiple images; billing follows the actual image count.

Smallest Example

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

Related Pages