This guide shows you how to migrate your applications from earlier versions of Imagen to Imagen 3. This guide covers the following topics: The following diagram summarizes the overall migration workflow: Migrating to Imagen 3 provides the following benefits: The Imagen 3 model you should migrate to depends on your current Imagen workload. The following table provides a high-level comparison to help you choose a model. The following table shows common workloads for Imagen 1 and
Imagen 2 models and their support by
Imagen 3 models: In most cases, you can migrate by updating the model name you are using to an
Imagen 3 model, with no other changes to your parameters.
The following sections describe exceptions that might affect you. If you use the Image Captioning and Visual Question Answering features in Imagen, migrate to Gemini Image Understanding. This service offers improved capabilities for analyzing and describing images. For more information, see Image understanding. Inpainting, outpainting, and product editing require API changes when migrating
to Imagen 3 models. For more information, see the following: For avatar stylization, migrate from Imagen 2
Personalization to
Imagen 3's Subject
customization, which
provides improved capabilities. Upgrading from earlier Imagen models might result in pricing changes. For pricing information, see the following pages:
Why migrate to Imagen 3?
imagegeneration@002
, imagegeneration@005
, and imagegeneration@006
models will be removed on September 24, 2025 .Which Imagen 3 model should I migrate to?
Model
Description
Use Case
imagen-3.0-generate-002
A streamlined model for high-quality, general-purpose image generation.
Choose this model for basic image generation workloads that don't require advanced editing or customization features.
imagen-3.0-capability-001
A comprehensive model that supports advanced features like inpainting, outpainting, and subject/style customization.
Choose this model if you use features like mask-based editing, personalization, or product image editing.
Feature
imagegeneration@002
imagegeneration@005
imagegeneration@006
imagen-3.0-
capability-001
generate-002
Image generation
Yes
Yes
Yes
No
Yes
Digital watermarking and verification
Yes
Yes
Yes
No
Yes
User-configurable safety settings
No
No
Yes
Yes
Yes
Image customization
No
No
Yes
Yes
No
Subject customization for product, person, and animal companion
Yes
No
No
Yes
No
Style customization
Yes
No
No
Yes
No
Mask-based image editing
Yes
No
No
Yes
No
Mask-free image editing
Yes
No
No
No
No
Insertion or removal image editing (inpainting)
No
No
Yes
Yes
No
Outpainting
No
No
Yes
Yes
No
Product image editing
Yes
No
Yes
Yes
No
Upscaling
Yes
No
No
No
No
Negative prompts
Yes
Yes
Yes
Yes
No
Person generation
No
No
Yes
No
Yes
Non-English text prompting
No
No
Yes
Yes
Yes
How to migrate
Image Captioning and Visual Question Answering
Inpainting, outpainting, and product editing
Personalization
Pricing changes
Migrate to Imagen 3
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-27 UTC.