Imagen 4 shut down on 17 August 2026: the generate_content() migration, with cost math

Imagen 4 shut down on 17 August 2026. Move to gemini-nano-banana-2.1 or Lite; two other models Google's docs name are deprecated.

Read time
15 min
Word count
2.2K
Sections
11
FAQs
8
Share
Diagram of the Imagen 4 shutdown: generate_images replaced by generate_content on Gemini image models
All three Imagen 4 models shut down on 17 August 2026; generate_images() is replaced by generate_content().
On this page · 11 sections
  1. Which replacement model is actually correct
  2. The three breaking changes
  3. A drop-in replacement for number_of_images
  4. The cost math
  5. What you lose, and what you gain
  6. A twelve-day plan
  7. India-specific considerations
  8. The pattern worth noticing
  9. FAQ
  10. How eCorpIT can help
  11. References

Summary. Google has shut down all three Imagen 4 models, imagen-4.0-generate-001, imagen-4.0-ultra-generate-001 and imagen-4.0-fast-generate-001 on the Gemini API; its deprecations table lists the date as 17 August 2026. In August that table named gemini-3.1-flash-image as the recommended replacement; it now names gemini-nano-banana-2.1, because Google deprecated gemini-3.1-flash-image on 6 October 2026. Google's own Imagen documentation page, last updated 17 September 2026, still says to use gemini-2.5-flash-image or Nano Banana 2 models such as gemini-3.1-flash-image. Follow that instruction and you land on a model with its own shutdown date of 15 March 2027, a second migration about seven months after the first, or on one that is already deprecated. The code change is three breaking edits: client.models.generate_images() becomes client.models.generate_content(), images arrive as content parts rather than in a generated_images array, and number_of_images (default 4, range 1–4) does not exist on Gemini image models, so one call now produces one image. On cost, the deprecated gemini-3.1-flash-image bills image output at $60.00 per 1M tokens, which Google works out to $0.045 per 0.5K image, $0.067 per 1K image, $0.101 per 2K and $0.151 per 4K. The batch tier halves that to $0.034 per 1K image, and gemini-3.1-flash-lite-image lists $0.0336 per 1K image on the standard tier. gemini-nano-banana-2.1 lists the same $0.0336 at 1K, $0.0504 at 2K and $0.113 at 4K, with input at $1.50 per 1M tokens. Imagen 4's own prices are no longer published on the Gemini API pricing page at all.

Update, 2 November 2026. Imagen 4 has gone from the Gemini API: Google's Imagen guide says the models are shut down, and the deprecations table lists 17 August 2026. Two things changed after we published. The shutdown date for gemini-2.5-flash-image moved from 2 October 2026 to 15 March 2027, with gemini-3.1-flash-lite-image as its replacement; our Nano Banana shutdown guide covers that move. And Google deprecated gemini-3.1-flash-image, the model we recommended, on 6 October 2026, and the deprecations table now names gemini-nano-banana-2.1 as the Imagen replacement. Agent Platform lists Imagen 4 Standard and Ultra as retired on 30 June 2026 and still names gemini-2.5-flash-image as the upgrade; do not follow that for new work.

Two other Gemini API shutdown dates fell in the same window and are easy to miss while you are looking at images: embedding-2-preview on 10 August 2026, and gemini-robotics-er-1.6-preview on 31 August 2026.

Which replacement model is actually correct

This is the part to get right before you write any code, because Google's documentation gives different answers.

The deprecations page, which is the page Google explicitly designates as the tracker, "the announced earliest shutdown dates are tracked on this page", lists all three Imagen 4 models with a shutdown date of 17 August 2026. In August its recommended replacement was gemini-3.1-flash-image. Google deprecated that model on 6 October 2026 with no shutdown date announced, although Agent Platform lists 28 May 2027 or later, and the table now names gemini-nano-banana-2.1 for all three Imagen 4 models.

The Imagen guide page says something else. In its migration section, the Model name line says to use gemini-2.5-flash-image or Nano Banana 2 models such as gemini-3.1-flash-image. But the same deprecations table lists gemini-2.5-flash-image with a shutdown date of 15 March 2027, moved from 2 October 2026, and a recommended replacement of gemini-3.1-flash-lite-image.

Model Status per the deprecations table Shutdown date Verdict
imagen-4.0-generate-001 Shut down 17 August 2026 Gone; remove any remaining calls
imagen-4.0-ultra-generate-001 Shut down 17 August 2026 Gone; remove any remaining calls
imagen-4.0-fast-generate-001 Shut down 17 August 2026 Gone; remove any remaining calls
gemini-2.5-flash-image Deprecated 15 March 2027 (moved from 2 October 2026) Named by the Imagen guide, do not migrate here
gemini-nano-banana-2.1 Released 6 October 2026 No shutdown date announced The correct target, named by the deprecations table
gemini-3.1-flash-image Deprecated 6 October 2026 No shutdown date announced Also named by the Imagen guide, do not start here
gemini-3.1-flash-lite-image Listed on the pricing page as the efficiency model No shutdown date announced The correct target for high-volume, cost-sensitive work at 1K

In August we advised moving to gemini-3.1-flash-image or gemini-3.1-flash-lite-image. Today use gemini-nano-banana-2.1 or gemini-3.1-flash-lite-image, because gemini-3.1-flash-image is now deprecated. Lite is 1K only. Treat the Imagen guide's gemini-2.5-flash-image line as stale documentation, not guidance. A stale doc page is the most expensive kind of bug on a deadline, because it looks authoritative and it costs you the whole migration twice.

One caveat worth stating plainly. Google's deprecations page carries a note that the listed dates "indicate the earliest possible dates on which a model might be retired" and that "We will communicate the exact shutdown date to users with advance notice." The note has mattered since: the date for gemini-2.5-flash-image moved from 2 October 2026 to 15 March 2027, while Imagen 4's 17 August date did not change and the Imagen guide now says the models are shut down.

The three breaking changes

Here is the Imagen 4 call as Google's own documentation wrote it, with number_of_images set to 4:


            from google import genai
from google.genai import types

client = genai.Client()

response = client.models.generate_images(
    model='imagen-4.0-generate-001',
    prompt='Robot holding a red skateboard',
    config=types.GenerateImagesConfig(
        number_of_images=4,
    )
)
for generated_image in response.generated_images:
    generated_image.image.show()
          

Three things in that snippet had to change.

The method changes. client.models.generate_images becomes client.models.generate_content. This is not an alias; the Imagen path used a :predict endpoint (https://generativelanguage.googleapis.com/v1beta/models/imagen-4.0-generate-001:predict) with an instances/parameters request body, and the Gemini path uses standard content generation.

The response shape changes. Google states it as "Nano Banana returns content parts, which may include image data, instead of a specific image response object." In practice that means walking response.candidates[0].content.parts and checking each part for inline_data. Code that reads response.generated_images throws an attribute error rather than returning an empty list, so this fails loudly, which is the one piece of good news here.

`number_of_images` is gone. On Imagen 4 the parameter accepted 1 to 4 and defaulted to 4. On the Gemini image models there is no equivalent, and a call returns one image. Every batch of N becomes N calls.

The replacement shape:


            import PIL.Image
from io import BytesIO
from google import genai

client = genai.Client()

response = client.models.generate_content(
    model="gemini-nano-banana-2.1",
    contents=["Robot holding a red skateboard"],
)

for part in response.candidates[0].content.parts:
    if part.text is not None:
        print(part.text)
    elif part.inline_data is not None:
        image = PIL.Image.open(BytesIO(part.inline_data.data))
        image.save("generated_image.png")
          

Note the part.text branch. Gemini image models can interleave text with images, so a parts loop that assumes every part is an image will crash on the first commentary token. Handle both. Google's image guide now uses the newer Interactions API in its samples, but its migration guide says generateContent remains fully supported.

A drop-in replacement for number_of_images

If your pipeline asked for four variants per prompt, you now need a fan-out. This helper keeps the old call signature so the rest of your code does not change, runs the calls concurrently, and returns the images in a list the way generated_images used to.


            import concurrent.futures
from io import BytesIO
from google import genai

client = genai.Client()
MODEL = "gemini-nano-banana-2.1"


def _one_image(prompt: str, model: str = MODEL) -> bytes | None:
    """Return raw PNG bytes for a single generation, or None if the model
    returned only text (a refusal or a safety block)."""
    response = client.models.generate_content(model=model, contents=[prompt])
    for part in response.candidates[0].content.parts:
        if getattr(part, "inline_data", None) is not None:
            return part.inline_data.data
    return None


def generate_images(prompt: str, number_of_images: int = 4,
                    model: str = MODEL) -> list[bytes]:
    """Fan-out replacement for the removed number_of_images parameter.
    Returns fewer than number_of_images if any call produced no image."""
    if not 1 <= number_of_images <= 8:
        raise ValueError("keep the fan-out small; each call bills separately")

    with concurrent.futures.ThreadPoolExecutor(max_workers=number_of_images) as pool:
        futures = [pool.submit(_one_image, prompt, model)
                   for _ in range(number_of_images)]
        results = [f.result() for f in futures]

    return [r for r in results if r is not None]
          

Two deliberate choices there. It returns a possibly-shorter list rather than padding, because a safety block or a text-only response is a real outcome your caller needs to see rather than a silent retry loop. And it caps the fan-out, because the thing that used to be one billable request is now N billable requests and an unbounded loop is how a test script turns into an invoice.

The cost math

The prices below are as listed on the Gemini API pricing page on 2 November 2026. gemini-3.1-flash-image is deprecated, so its rows are for teams that already moved there. Thinking is on by default on Gemini 3 image models and bills at the text and thinking rate.

Model and tier Image output rate Per 1K (1024x1024) image Text and thinking output Input
gemini-nano-banana-2.1, standard $30.00 per 1M tokens $0.0336 (1,120 tokens) $7.50 per 1M $1.50 per 1M (text/image/video)
gemini-nano-banana-2.1, batch $15.00 per 1M tokens $0.0168 $3.75 per 1M $0.75 per 1M
gemini-nano-banana-2.1, 2K (2048x2048) $30.00 per 1M tokens $0.0504 (1,680 tokens) N/A N/A
gemini-nano-banana-2.1, 4K (4096x4096) $30.00 per 1M tokens $0.113 (3,780 tokens) N/A N/A
gemini-3.1-flash-image, standard $60.00 per 1M tokens $0.067 (1,120 tokens) $3.00 per 1M $0.50 per 1M (text/image)
gemini-3.1-flash-image, batch $30.00 per 1M tokens $0.034 $1.50 per 1M $0.25 per 1M
gemini-3.1-flash-lite-image, standard $30.00 per 1M tokens $0.0336 $1.50 per 1M $0.25 per 1M (text/image/video)
gemini-3.1-flash-image, 0.5K (512px) $60.00 per 1M tokens $0.045 (747 tokens) , ,
gemini-3.1-flash-image, 2K (2048x2048) $60.00 per 1M tokens $0.101 (1,680 tokens) — —
gemini-3.1-flash-image, 4K (4096x4096) $60.00 per 1M tokens $0.151 (2,520 tokens) — —

Three observations that matter more than the headline rate.

Resolution is the biggest lever you control. Going from 4K to 1K on gemini-nano-banana-2.1 cuts the per-image cost from $0.113 to $0.0336, a 70% reduction, because the image consumes 1,120 output tokens instead of 3,780. Google's image guide still shows 2,520 tokens at 4K for that model; we use the pricing page figure. Most pipelines generating thumbnails, product tiles or social crops are paying 4K rates for assets that get downsampled anyway. Audit your image_size before you audit anything else.

Batch is half price and most image pipelines are batchable. Standard 1K at $0.0336 becomes $0.0168 on the batch tier for gemini-nano-banana-2.1. If your generation is a nightly job, a content pipeline or anything that does not need a synchronous response, that is a 50% saving for a scheduling change.

The fan-out has an input-token cost. Under Imagen 4, one call with number_of_images=4 sent the prompt once. Under the Gemini models, four calls send the prompt four times, each billing input at $1.50 per 1M tokens on the standard tier of gemini-nano-banana-2.1, or $0.25 on Lite. For a short prompt that is negligible; for a pipeline that sends a long style guide or reference images with every request, it is four times the input bill for the same four outputs. Where you are generating variants of the same prompt, that repeated input is the line item to check.

Imagen 4's own per-image prices are no longer on the Gemini API pricing page, which no longer mentions Imagen at all. You cannot look up what you were paying from the primary source, so pull the actual figure from your billing console rather than a third-party comparison page.

What you lose, and what you gain

The migration is not purely a rename, and some Imagen-specific configuration has no direct successor in the same form.

Imagen 4 capability Detail as documented After migration
numberOfImages 1 to 4, default 4 No equivalent; fan out in application code
imageSize 1K and 2K, Standard and Ultra models only gemini-nano-banana-2.1 is priced at 1K, 2K and 4K, so 4K becomes available; Lite is 1K only and 0.5K is only on gemini-3.1-flash-image
aspectRatio "1:1", "3:4", "4:3", "9:16", "16:9", default "1:1" Check the image generation guide for the current parameter before assuming parity
personGeneration "dont_allow", "allow_adult" (default), "allow_all" Verify the equivalent control; "allow_all" was already blocked in EU, UK, CH and MENA locations
Prompt length Maximum 480 tokens, English only Gemini image models are general multimodal models, not subject to the Imagen text-only limit
SynthID "All generated images include a SynthID watermark" Verify watermarking behaviour on the target model before shipping regulated content
Response object response.generated_images[].image response.candidates[0].content.parts[].inline_data

The gains are real. You get 4K output, which Imagen 4 did not offer through this API — its imageSize topped out at 2K. You get interleaved text and image responses, which makes conversational editing possible in a way the predict-style endpoint did not. And you get a cheaper per-image floor via the lite model and the batch tier.

The losses are mostly ergonomic. Losing number_of_images is the one that touches real code, and the fan-out above closes it.

A twelve-day plan

We wrote this for the twelve days before 17 August 2026. That date has passed, so any call site still on Imagen 4 no longer works. The steps still apply, and they fit inside one sprint.

Days Action Exit criteria
1 Grep for generate_images, generateImages, GenerateImages, imagen-4.0, generated_images and :predict across every repository, notebook and scheduled job A list of call sites with an owner each
1 Pull last month's image counts and resolutions from billing; decide the target model and tier per pipeline A written before/after cost estimate
2–4 Swap the method and the response parsing; add the fan-out helper where number_of_images was used; handle the part.text branch Unit tests pass against the new response shape
5–7 Verify the parameters you relied on — aspect ratio, resolution, person generation, watermarking — against the image generation guide on the target model A parity checklist with a pass or an accepted difference per row
8–10 Run the new path on a sample workload against saved Imagen output; compare output quality, latency and per-image cost Quality signed off by whoever owns the output
11–12 Cut over, delete the Imagen path, and alert on any non-image response No imagen-4.0 string anywhere in the codebase
Also Check for embedding-2-preview usage; its listed shutdown date was 10 August 2026, and gemini-embedding-2 replaces it Embedding calls confirmed on a supported model
By mid-February 2027 Move anything on gemini-2.5-flash-image to a current model; its listed shutdown date is 15 March 2027 No gemini-2.5-flash-image string anywhere in the codebase

The embedding row is the one that catches people. Teams doing an image migration will not be looking at their embedding model, and embedding-2-preview had a listed date seven days before Imagen's.

India-specific considerations

For teams in Gurugram, Bengaluru, Pune and Hyderabad running image generation at volume for D2C catalogues, marketplace listings or ad creative, three points apply.

The batch tier is the single largest saving available and it fits Indian catalogue workflows well. Product imagery for a listing refresh does not need a synchronous response. Moving that generation to batch takes a 1K image from $0.0336 to $0.0168, and at catalogue scale — tens of thousands of images per refresh cycle — that difference is the entire argument for scheduling the job overnight rather than generating on upload.

Resolution discipline matters more here than in most markets, because marketplace and quick-commerce listing specs are modest. If your target surface renders at 1024px or below, generating at 4K on gemini-nano-banana-2.1 and downsampling costs $0.113 instead of $0.0336 for an asset nobody sees at full resolution.

On governance, personGeneration on Imagen 4 had a documented regional restriction — "allow_all" was "not allowed in EU, UK, CH, MENA locations" — and any equivalent control on the target model needs to be verified rather than assumed, particularly if you generate imagery depicting people for campaigns that run across those regions. Where generated imagery is derived from customer photographs or user-submitted references, the Digital Personal Data Protection Act 2023 obligations attached to that source data follow it into the generation pipeline, so keep the reference store governed the same way as the rest of your customer data.

The pattern worth noticing

This is the second image-model migration in roughly a year for anyone who was on Imagen 3, which the same documentation records as already shut down. The Gemini API deprecations page shows the cadence clearly: preview models routinely carry shutdown dates a few months out, and even GA models get them. gemini-2.5-flash-image, released 2 October 2025, first had a shutdown date exactly one year later, now moved to 15 March 2027. gemini-3.1-flash-image, released 28 May 2026, was deprecated about four months later.

The practical response is architectural rather than tactical. Put the model ID in configuration, not in a call site. Wrap generation behind one function with a stable signature — the fan-out helper above is a start — so that the next deprecation is a config change and a parsing tweak rather than a search through six repositories. Teams that did this can treat the 15 March 2027 date as an afternoon's work. Teams that did not will spend the week.

FAQ

How eCorpIT can help

We run image and model migrations like this one for teams that discovered the deadline late: inventory the call sites, model the per-image cost against your real resolution mix, swap the call and the parsing, and verify parameter parity before cutover rather than after. eCorpIT is CMMI Level 5 and ISO 27001:2022 certified, and our senior engineering teams design generation pipelines aligned with DPDP requirements. If 15 March 2027 is on your calendar without an owner, talk to us.

Related reading: our AI image generation API cost comparison sets these rates against the other providers, the Nano Banana 2 versus Nano Banana Pro production comparison covers model selection for production work, the Gemini video generation cost guide applies the same per-token arithmetic to video, and the frontier model comparison is the pillar for this cluster.

References

  1. Gemini API deprecations (shutdown dates and recommended replacements) — Google AI for Developers
  1. Generate images using Imagen (deprecation banner, configuration parameters, code samples) — Google AI for Developers
  1. Gemini Developer API pricing — Google AI for Developers
  1. Image generation guide — Google AI for Developers
  1. Gemini API release notes — Google AI for Developers
  1. Generating content API reference — Google AI for Developers
  1. Gemini 3.1 Flash Image in Google AI Studio
  1. Gemini API models overview — Google AI for Developers
  1. Introducing Gemini 2.5 Flash Image — Google Developers Blog
  1. Generate and edit images using Gemini — Firebase AI Logic
  1. Imagen models migration — Firebase AI Logic
  1. Gemini API terms of service — Google AI for Developers
  1. Model versions and lifecycle — Google Cloud
  1. Gemini Nano Banana 2.1 model page — Google AI for Developers
  1. Migrating to the Interactions API — Google AI for Developers

Last updated: 2 November 2026.

Frequently asked

Quick answers.

01 Which Imagen models shut down on 17 August 2026?
Three of them: imagen-4.0-generate-001, imagen-4.0-ultra-generate-001 and imagen-4.0-fast-generate-001. All three were released on 24 June 2025 and all three carry the same 17 August 2026 shutdown date in the Gemini API deprecations table. Imagen 3's imagen-3.0-generate-002 was already shut down earlier, on 10 November 2025.
02 Should I migrate to gemini-2.5-flash-image or gemini-3.1-flash-image?
Neither. gemini-2.5-flash-image is due to shut down on 15 March 2027, and Google deprecated gemini-3.1-flash-image on 6 October 2026 with no shutdown date announced. The deprecations table now names gemini-nano-banana-2.1 as the replacement for Imagen 4. For high-volume 1K work, gemini-3.1-flash-lite-image also fits.
03 What are the three code changes I have to make?
Call client.models.generate_content instead of client.models.generate_images. Read images from response.candidates[0].content.parts by checking each part for inline_data, rather than from response.generated_images. And replace number_of_images, which does not exist on Gemini image models, with your own fan-out because each call returns one image.
04 How much does an image cost after migrating?
On gemini-nano-banana-2.1, image output bills at $30.00 per 1M tokens, which Google states as $0.0336 per 1K image, $0.0504 per 2K and $0.113 per 4K. The batch tier halves those figures, putting a 1K image at $0.0168, and gemini-3.1-flash-lite-image also lists $0.0336 at 1K. The deprecated gemini-3.1-flash-image lists $0.067.
05 Does the fan-out cost more than a single Imagen call did?
For the output, no — you pay per image either way. For input, yes. One Imagen call with number_of_images=4 sent the prompt once; four Gemini calls send it four times, billed at $1.50 per 1M input tokens on the standard tier of gemini-nano-banana-2.1. That matters when the prompt carries long style instructions or reference images.
06 What else in the Gemini API shut down around the same time?
Two other models had dates in the same window. embedding-2-preview was listed for 10 August 2026, with gemini-embedding-2 named as the replacement, and gemini-robotics-er-1.6-preview for 31 August 2026, replaced by gemini-robotics-er-2-preview. Both are easy to miss while you are auditing image generation code specifically, so check for them too.
07 Did the 17 August date hold?
Google's pages say so. The deprecations table still lists 17 August 2026, and the Imagen guide, updated on 17 September 2026, says the models are shut down and no longer available in the Gemini API. Listed dates are the earliest possible, though, and the date for gemini-2.5-flash-image did move, to 15 March 2027.
08 Do I get anything back from this migration?
Yes. 4K output becomes available, where Imagen 4's imageSize supported only 1K and 2K and only on the Standard and Ultra models. Responses can interleave text with images, which makes conversational editing workflows possible. And the batch tier and the lite model both offer a lower per-image floor than the standard rate.

About the author

Manu Shukla

Founder & Director

Founder of eCorpIT. Hands-on engineer leading senior-only delivery for AI apps, custom software, and cloud systems for global clients.

Subscribe

One engineering note a week. No fluff, no spam.

Senior-architect playbooks on AI agents, mobile apps, cloud, security, data, and marketing — delivered every Wednesday.

Past the reading

Read enough. Let's build something.

A senior architect responds in 24 working hours with scope, indicative cost, and a timeline. NDA before any technical conversation.

Loading search…

Browse all guides