GPT Image 2
OpenAI text-to-image and image editing at 1K with up to 15 reference images and wide aspect ratios.
- Model id
gpt-image-2- Price
- 12 credits / image
- Output
- 1K
- Reference images
- Up to 15
- Typical time
- 15–30 seconds
Aspect ratios
/api/v1/generations12 credits per image at every quality setting. Reference images do not add an extra charge. Check credits_refunded to confirm a refund; unresolved submissions may require review.
Authorization
AuthorizationstringrequiredBearer fx1_live_… — send your API key in the request header. Requires a completed paid purchase; new generations also require enough credits.
Idempotency-KeystringoptionalUse one unique value per generation and reuse it with the same body on retries. Printable ASCII, no spaces. A different body with the same key returns 409.
Maximum length: 128 characters
Request body
modelstringrequiredUse this exact model ID in the top-level request body.
gpt-image-2promptstringrequiredDescribe the image to create, or the changes to make to your reference images. Whitespace is trimmed.
Maximum length: 5,000 characters
imagesstring[]optionalOptional reference images. Use publicly accessible HTTPS URLs or data:image/* base64 URIs (up to 20,000,000 characters per entry). Omit for text-to-image.
Maximum items: 15
aspect_ratiostringoptionalOutput width-to-height ratio. Auto lets the model choose.
Default: auto
auto1:12:33:23:44:34:55:49:1616:921:92:11:23:11:39:21Response & next step
A successful submission returns 202 and a generation id. Poll GET /api/v1/generations/{id} every 2–3 seconds until the status is succeeded or failed.
Read the result URL from output.images[0].url. Download it before expires_at (30 days after storage). On failure, inspect error and credits_refunded.