DALL-E 3 API Deprecated: Migrate to gpt-image

How to fix it

// try these in order, the most common fix is first

1. FIX 1Change the model and check access

   Copy steps
   1. 01Set model to the replacement listed on OpenAI's deprecations page (gpt-image-2, gpt-image-1 or gpt-image-1-mini were listed for dall-e)
   2. 02Gpt-image models may require API Organization Verification before first use
   Did this fix it? Yes No

2. FIX 2Update request parameters

   Copy steps
   1. 01Replace quality: hd with high and standard with medium or low
   2. 02Replace 1792x1024 with 1536x1024 and 1024x1792 with 1024x1536
   3. 03Remove style and response_format; describe style in the prompt
   4. 04Optionally set output_format (png, jpeg, webp) and moderation (low or auto)
   Did this fix it? Yes No

3. FIX 3Handle base64 output

   Copy steps
   1. 01Read data[0].b64_json instead of data[0].url
   2. 02Decode and store or serve the bytes yourself, since there is no hosted URL
   Did this fix it? Yes No

4. FIX 4Redo cost estimates

   Copy steps
   1. 01Billing is per token for text input, input images (edits) and output image tokens
   2. 02Estimate with OpenAI's pricing page and test real calls
   Did this fix it? Yes No

5. FIX 5Plan for the next retirement

   Copy steps
   1. 01Newer models also retire: OpenAI's page lists gpt-image-1 (Oct 23, 2026) and gpt-image-1.5, gpt-image-1-mini and chatgpt-image-latest (Dec 1, 2026)
   2. 02Keep the model ID in config so you can switch quickly
   Did this fix it? Yes No

Symptoms

Requests return invalid_request_error with code model_not_found, or fail with unknown parameter errors after you change the model name.

Why it happens

• C-01The dall-e model IDs no longer exist and there is no automatic fallback
• C-02gpt-image models return base64 (b64_json) only, no hosted URL
• C-03quality values changed from standard/hd to low/medium/high/auto
• C-04Sizes changed to 1024x1024, 1024x1536, 1536x1024 or auto
• C-05The style parameter (vivid/natural) was removed
• C-06Billing moved from a flat per-image price to token-based

// this guide also covers

• dall-e-3 api deprecated
• dall-e-3 model_not_found
• migrate dall-e 3 to gpt-image-1
• dall-e 3 replacement api

The same problem in other apps

All ai & editing tools not working guides →

• Stable Diffusion Black Images and NaN Error (Stable Diffusion)
• Leonardo.ai Tokens Ran Out: Why and What to Do (Leonardo.ai)

Other DALL-E errors

• Is DALL-E 3 Discontinued? What to Use Now
• DALL-E / ChatGPT Image Content Policy Violation Error
• ChatGPT Image Generation Not Working
• ChatGPT Image Creation Limit Reached
• OpenAI Images API 429 Rate Limit Error
• OpenAI 'Organization Must Be Verified' Error for gpt-image
• DALL-E / ChatGPT Images Quality Declined or Blurry
• DALL-E / ChatGPT Images Text Spelling Wrong