Get Image Models
Machine-readable capabilities of available image models: aspect ratios, resolutions, reference image limits, and base price: credit_per_image at the default resolution, plus credit_by_resolution for every supported resolution (GPT Image models cost more at 2K). reference_pricing describes any surcharge added to that base: only GPT Image 2 charges 1 extra credit per additional group of up to 3 references after the first 6 (maximum 16). Null means no reference surcharge; GPT Image 2.5 models remain limited to 6 references.
Headers
sk-vs-...), kept server-side. Create one at OpenApi (Pro plan and up).Response
Successful calls return a standard envelope: the endpoint payload under data (its fields are documented below), plus a message string ("success") and an ISO 8601 server_time.
data)Errors
All error responses share one JSON envelope: an error object with a numeric code, a human-readable message, an optional details string, and an optional hint giving an actionable next step (handy for AI agents).