Migrate to Imagen 3

This guide explains how to migrate your applications from Imagen 1 and Imagen 2 to Imagen 3.

Why migrate to Imagen 3?

Imagen 3 offers performance improvements over Imagen 1 and Imagen 2.

Upgrading most Imagen applications to Imagen 3 shouldn't require significant reengineering of prompts or code. But some applications may require prompt changes, and these changes are difficult to predict without running a prompt through Imagen 3 first.

Which Imagen 3 model should I migrate to?

The Imagen workloads that you use determine which Imagen 3 model we recommend for your migration.

The following table shows common workloads for Imagen 1 and Imagen 2 models and their support by Imagen 3 models:

Feature imagegeneration@002 imagegeneration@005 imagegeneration@006 imagen-3.0-
capability-001 generate-001 generate-002
Image generation Yes Yes Yes No Yes Yes
Digital watermarking and verification Yes Yes Yes No Yes Yes
User-configurable safety settings No No Yes Yes Yes Yes
Image customization No No Yes Yes No No
Subject customization for product, person, and animal companion Yes No No Yes No No
Style customization Yes No No Yes No No
Mask-based image editing Yes No No Yes No No
Mask-free image editing Yes No No Yes No No
Insertion or removal image editing (inpainting) No No Yes Yes No No
Outpainting No No Yes Yes No No
Product image editing Yes No Yes Yes No No
Upscaling Yes No No No No No
Negative prompts Yes Yes Yes Yes Yes No
Person generation No No Yes No Yes Yes
Non-English text prompting No No Yes Yes Yes No

How do I migrate?

In most cases you can update the model name that you are using to use an Imagen 3 model with no further changes to your parameters. The following sections provide exceptions that may affect you.

Text-to-Live images

If you use the Text-to-Live Images feature in Imagen, we recommend migrating to the Text-to-Video feature in Veo on Vertex AI for improved image quality.

For more information, see Veo | AI Video Generator.

Image Captioning and Visual Question Answering

If you use Imagen's Image Captioning and Visual Question Answering features, we recommend that you migrate to Gemini Image Understanding for improved capabilities for analyzing and describing images.

For more information, see Image understanding.

Inpainting, outpainting, and product editing

Inpainting, outpainting, and product editing require API changes when migrating to Imagen 3 models. For more information, see the following:

Personalization

For avatar stylization, migrate from Imagen 2 Personalization to Imagen 3's Subject customization, which provides improved capabilities.

Are there pricing changes?

There may be pricing changes for upgrading from earlier Imagen models.

For information about pricing, see the following: