From 724d4a31db668c7bb51b4bde8f7ef64d5ba5c7a7 Mon Sep 17 00:00:00 2001
From: Vinay Guthal <vguthal@google.com>
Date: Mon, 4 May 2026 12:06:20 -0400
Subject: [PATCH 1/2] update

---
 .../com/google/firebase/ai/TemplateImagenModel.kt      | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/TemplateImagenModel.kt b/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/TemplateImagenModel.kt
index 57a317607f9..516463973cf 100644
--- a/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/TemplateImagenModel.kt
+++ b/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/TemplateImagenModel.kt
@@ -36,7 +36,12 @@ import org.json.JSONObject
  *
  * See the documentation for a list of
  * [supported models](https://firebase.google.com/docs/ai-logic/models).
+ *
+ * @deprecated **Deprecation Notice:** All Imagen models are deprecated and will shut down as early
+ * as June 2026. As a replacement, you can
+ * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
  */
+@Deprecated("All Imagen models are deprecated.")
 @PublicPreviewAPI
 public class TemplateImagenModel
 internal constructor(
@@ -75,7 +80,12 @@ internal constructor(
    *
    * @param templateId The ID of server prompt template.
    * @param inputs the inputs needed to fill in the prompt
+   *
+   * @deprecated **Deprecation Notice:** All Imagen models are deprecated and will shut down as
+   * early as June 2026. As a replacement, you can
+   * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
    */
+  @Deprecated("All Imagen models are deprecated.")
   public suspend fun generateImages(
     templateId: String,
     inputs: Map<String, Any>

From a1c92cfa494d606f90e4c853b53ab8876177aa9c Mon Sep 17 00:00:00 2001
From: Vinay Guthal <vguthal@google.com>
Date: Tue, 5 May 2026 11:44:20 -0400
Subject: [PATCH 2/2] address comments

---
 .../com/google/firebase/ai/ImagenModel.kt     | 10 ++++----
 .../google/firebase/ai/TemplateImagenModel.kt |  4 ++--
 .../firebase/ai/java/ImagenModelFutures.kt    | 17 ++++++-------
 .../firebase/ai/type/ImagenAspectRatio.kt     |  2 +-
 .../firebase/ai/type/ImagenControlType.kt     |  2 +-
 .../google/firebase/ai/type/ImagenEditMode.kt |  2 +-
 .../firebase/ai/type/ImagenEditingConfig.kt   |  2 +-
 .../ai/type/ImagenGenerationConfig.kt         | 18 +++++++-------
 .../ai/type/ImagenGenerationResponse.kt       |  2 +-
 .../firebase/ai/type/ImagenImageFormat.kt     |  6 ++---
 .../firebase/ai/type/ImagenImagePlacement.kt  |  4 ++--
 .../firebase/ai/type/ImagenInlineImage.kt     |  6 ++---
 .../ai/type/ImagenPersonFilterLevel.kt        |  2 +-
 .../firebase/ai/type/ImagenReferenceImage.kt  | 24 +++++++++----------
 .../ai/type/ImagenSafetyFilterLevel.kt        |  2 +-
 .../ai/type/ImagenSubjectReferenceType.kt     |  2 +-
 16 files changed, 53 insertions(+), 52 deletions(-)

diff --git a/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/ImagenModel.kt b/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/ImagenModel.kt
index d16a528fb49..d5ab2802e70 100644
--- a/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/ImagenModel.kt
+++ b/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/ImagenModel.kt
@@ -49,7 +49,7 @@ import com.google.firebase.auth.internal.InternalAuthProvider
  * as June 2026. As a replacement, you can
  * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
  */
-@Deprecated("All Imagen models are deprecated.")
+@Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
 public class ImagenModel
 internal constructor(
   private val modelName: String,
@@ -96,7 +96,7 @@ internal constructor(
    * early as June 2026. As a replacement, you can
    * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
    */
-  @Deprecated("All Imagen models are deprecated.")
+  @Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
   public suspend fun generateImages(prompt: String): ImagenGenerationResponse<ImagenInlineImage> =
     try {
       controller
@@ -119,7 +119,7 @@ internal constructor(
    * early as June 2026. As a replacement, you can
    * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
    */
-  @Deprecated("All Imagen models are deprecated.")
+  @Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
   @PublicPreviewAPI
   public suspend fun editImage(
     referenceImages: List<ImagenReferenceImage>,
@@ -149,7 +149,7 @@ internal constructor(
    * early as June 2026. As a replacement, you can
    * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
    */
-  @Deprecated("All Imagen models are deprecated.")
+  @Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
   @PublicPreviewAPI
   public suspend fun inpaintImage(
     image: ImagenInlineImage,
@@ -179,7 +179,7 @@ internal constructor(
    * early as June 2026. As a replacement, you can
    * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
    */
-  @Deprecated("All Imagen models are deprecated.")
+  @Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
   @PublicPreviewAPI
   public suspend fun outpaintImage(
     image: ImagenInlineImage,
diff --git a/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/TemplateImagenModel.kt b/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/TemplateImagenModel.kt
index 516463973cf..5c855a030f1 100644
--- a/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/TemplateImagenModel.kt
+++ b/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/TemplateImagenModel.kt
@@ -41,7 +41,7 @@ import org.json.JSONObject
  * as June 2026. As a replacement, you can
  * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
  */
-@Deprecated("All Imagen models are deprecated.")
+@Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
 @PublicPreviewAPI
 public class TemplateImagenModel
 internal constructor(
@@ -85,7 +85,7 @@ internal constructor(
    * early as June 2026. As a replacement, you can
    * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
    */
-  @Deprecated("All Imagen models are deprecated.")
+  @Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
   public suspend fun generateImages(
     templateId: String,
     inputs: Map<String, Any>
diff --git a/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/java/ImagenModelFutures.kt b/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/java/ImagenModelFutures.kt
index ccbc7b8d8f2..1914f71d4a5 100644
--- a/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/java/ImagenModelFutures.kt
+++ b/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/java/ImagenModelFutures.kt
@@ -38,7 +38,7 @@ import com.google.firebase.ai.type.PublicPreviewAPI
  * as June 2026. As a replacement, you can
  * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
  */
-@Deprecated("All Imagen models are deprecated.")
+@Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
 @PublicPreviewAPI
 public abstract class ImagenModelFutures internal constructor() {
   /**
@@ -50,7 +50,7 @@ public abstract class ImagenModelFutures internal constructor() {
    * early as June 2026. As a replacement, you can
    * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
    */
-  @Deprecated("All Imagen models are deprecated.")
+  @Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
   public abstract fun generateImages(
     prompt: String,
   ): ListenableFuture<ImagenGenerationResponse<ImagenInlineImage>>
@@ -67,7 +67,7 @@ public abstract class ImagenModelFutures internal constructor() {
    * early as June 2026. As a replacement, you can
    * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
    */
-  @Deprecated("All Imagen models are deprecated.")
+  @Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
   public abstract fun editImage(
     referenceImages: List<ImagenReferenceImage>,
     prompt: String,
@@ -85,7 +85,7 @@ public abstract class ImagenModelFutures internal constructor() {
    * early as June 2026. As a replacement, you can
    * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
    */
-  @Deprecated("All Imagen models are deprecated.")
+  @Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
   public abstract fun editImage(
     referenceImages: List<ImagenReferenceImage>,
     prompt: String,
@@ -103,7 +103,7 @@ public abstract class ImagenModelFutures internal constructor() {
    * early as June 2026. As a replacement, you can
    * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
    */
-  @Deprecated("All Imagen models are deprecated.")
+  @Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
   public abstract fun inpaintImage(
     image: ImagenInlineImage,
     prompt: String,
@@ -129,7 +129,7 @@ public abstract class ImagenModelFutures internal constructor() {
    * early as June 2026. As a replacement, you can
    * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
    */
-  @Deprecated("All Imagen models are deprecated.")
+  @Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
   public abstract fun outpaintImage(
     image: ImagenInlineImage,
     newDimensions: Dimensions,
@@ -145,7 +145,8 @@ public abstract class ImagenModelFutures internal constructor() {
    * early as June 2026. As a replacement, you can
    * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
    */
-  @Deprecated("All Imagen models are deprecated.") public abstract fun getImageModel(): ImagenModel
+  @Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
+  public abstract fun getImageModel(): ImagenModel
 
   private class FuturesImpl(private val model: ImagenModel) : ImagenModelFutures() {
     override fun generateImages(
@@ -197,7 +198,7 @@ public abstract class ImagenModelFutures internal constructor() {
      * early as June 2026. As a replacement, you can
      * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
      */
-    @Deprecated("All Imagen models are deprecated.")
+    @Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
     @JvmStatic
     public fun from(model: ImagenModel): ImagenModelFutures = FuturesImpl(model)
   }
diff --git a/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenAspectRatio.kt b/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenAspectRatio.kt
index f67896a11c8..450c31bbad3 100644
--- a/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenAspectRatio.kt
+++ b/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenAspectRatio.kt
@@ -23,7 +23,7 @@ package com.google.firebase.ai.type
  * as June 2026. As a replacement, you can
  * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
  */
-@Deprecated("All Imagen models are deprecated.")
+@Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
 public class ImagenAspectRatio private constructor(internal val internalVal: String) {
   public companion object {
     /** A square image, useful for icons, profile pictures, etc. */
diff --git a/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenControlType.kt b/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenControlType.kt
index a770e6e84ff..1c565c2a80b 100644
--- a/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenControlType.kt
+++ b/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenControlType.kt
@@ -22,7 +22,7 @@ package com.google.firebase.ai.type
  * as June 2026. As a replacement, you can
  * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
  */
-@Deprecated("All Imagen models are deprecated.")
+@Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
 public class ImagenControlType internal constructor(internal val value: String) {
   public companion object {
 
diff --git a/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenEditMode.kt b/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenEditMode.kt
index b80ab24565d..2b5265c7025 100644
--- a/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenEditMode.kt
+++ b/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenEditMode.kt
@@ -22,7 +22,7 @@ package com.google.firebase.ai.type
  * as June 2026. As a replacement, you can
  * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
  */
-@Deprecated("All Imagen models are deprecated.")
+@Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
 public class ImagenEditMode private constructor(internal val value: String) {
 
   public companion object {
diff --git a/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenEditingConfig.kt b/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenEditingConfig.kt
index eeb35ea4c54..f9a67bc4d60 100644
--- a/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenEditingConfig.kt
+++ b/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenEditingConfig.kt
@@ -26,7 +26,7 @@ import kotlinx.serialization.Serializable
  * as June 2026. As a replacement, you can
  * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
  */
-@Deprecated("All Imagen models are deprecated.")
+@Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
 @PublicPreviewAPI
 public class ImagenEditingConfig(
   internal val editMode: ImagenEditMode? = null,
diff --git a/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenGenerationConfig.kt b/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenGenerationConfig.kt
index db00a0ed383..623adcc1ea4 100644
--- a/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenGenerationConfig.kt
+++ b/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenGenerationConfig.kt
@@ -32,7 +32,7 @@ package com.google.firebase.ai.type
  */
 import kotlin.jvm.JvmField
 
-@Deprecated("All Imagen models are deprecated.")
+@Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
 public class ImagenGenerationConfig(
   public val negativePrompt: String? = null,
   public val numberOfImages: Int? = 1,
@@ -50,7 +50,7 @@ public class ImagenGenerationConfig(
    * early as June 2026. As a replacement, you can
    * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
    */
-  @Deprecated("All Imagen models are deprecated.")
+  @Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
   public class Builder {
     @JvmField public var negativePrompt: String? = null
     @JvmField public var numberOfImages: Int? = 1
@@ -65,7 +65,7 @@ public class ImagenGenerationConfig(
      * early as June 2026. As a replacement, you can
      * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
      */
-    @Deprecated("All Imagen models are deprecated.")
+    @Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
     public fun setNegativePrompt(negativePrompt: String): Builder = apply {
       this.negativePrompt = negativePrompt
     }
@@ -77,7 +77,7 @@ public class ImagenGenerationConfig(
      * early as June 2026. As a replacement, you can
      * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
      */
-    @Deprecated("All Imagen models are deprecated.")
+    @Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
     public fun setNumberOfImages(numberOfImages: Int): Builder = apply {
       this.numberOfImages = numberOfImages
     }
@@ -89,7 +89,7 @@ public class ImagenGenerationConfig(
      * early as June 2026. As a replacement, you can
      * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
      */
-    @Deprecated("All Imagen models are deprecated.")
+    @Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
     public fun setAspectRatio(aspectRatio: ImagenAspectRatio): Builder = apply {
       this.aspectRatio = aspectRatio
     }
@@ -101,7 +101,7 @@ public class ImagenGenerationConfig(
      * early as June 2026. As a replacement, you can
      * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
      */
-    @Deprecated("All Imagen models are deprecated.")
+    @Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
     public fun setImageFormat(imageFormat: ImagenImageFormat): Builder = apply {
       this.imageFormat = imageFormat
     }
@@ -113,7 +113,7 @@ public class ImagenGenerationConfig(
      * early as June 2026. As a replacement, you can
      * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
      */
-    @Deprecated("All Imagen models are deprecated.")
+    @Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
     public fun setAddWatermark(addWatermark: Boolean): Builder = apply {
       this.addWatermark = addWatermark
     }
@@ -128,7 +128,7 @@ public class ImagenGenerationConfig(
      * early as June 2026. As a replacement, you can
      * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
      */
-    @Deprecated("All Imagen models are deprecated.")
+    @Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
     public fun build(): ImagenGenerationConfig =
       ImagenGenerationConfig(
         negativePrompt = negativePrompt,
@@ -162,7 +162,7 @@ public class ImagenGenerationConfig(
  * as June 2026. As a replacement, you can
  * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
  */
-@Deprecated("All Imagen models are deprecated.")
+@Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
 public fun imagenGenerationConfig(
   init: ImagenGenerationConfig.Builder.() -> Unit
 ): ImagenGenerationConfig {
diff --git a/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenGenerationResponse.kt b/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenGenerationResponse.kt
index 4dbd9c19972..69101c49aeb 100644
--- a/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenGenerationResponse.kt
+++ b/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenGenerationResponse.kt
@@ -31,7 +31,7 @@ import kotlinx.serialization.Serializable
  * as June 2026. As a replacement, you can
  * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
  */
-@Deprecated("All Imagen models are deprecated.")
+@Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
 public class ImagenGenerationResponse<T>
 internal constructor(public val images: List<T>, public val filteredReason: String?) {
 
diff --git a/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenImageFormat.kt b/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenImageFormat.kt
index 250c4b56b3b..ffaed4d5258 100644
--- a/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenImageFormat.kt
+++ b/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenImageFormat.kt
@@ -30,7 +30,7 @@ import kotlinx.serialization.Serializable
  * as June 2026. As a replacement, you can
  * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
  */
-@Deprecated("All Imagen models are deprecated.")
+@Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
 public class ImagenImageFormat
 private constructor(public val mimeType: String, public val compressionQuality: Int?) {
 
@@ -49,7 +49,7 @@ private constructor(public val mimeType: String, public val compressionQuality:
      * early as June 2026. As a replacement, you can
      * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
      */
-    @Deprecated("All Imagen models are deprecated.")
+    @Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
     @JvmStatic
     public fun jpeg(compressionQuality: Int? = null): ImagenImageFormat {
       return ImagenImageFormat("image/jpeg", compressionQuality)
@@ -62,7 +62,7 @@ private constructor(public val mimeType: String, public val compressionQuality:
      * early as June 2026. As a replacement, you can
      * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
      */
-    @Deprecated("All Imagen models are deprecated.")
+    @Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
     @JvmStatic
     public fun png(): ImagenImageFormat {
       return ImagenImageFormat("image/png", null)
diff --git a/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenImagePlacement.kt b/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenImagePlacement.kt
index 65d373743b3..e4c52586ec8 100644
--- a/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenImagePlacement.kt
+++ b/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenImagePlacement.kt
@@ -23,7 +23,7 @@ package com.google.firebase.ai.type
  * as June 2026. As a replacement, you can
  * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
  */
-@Deprecated("All Imagen models are deprecated.")
+@Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
 public class ImagenImagePlacement
 private constructor(public val x: Int? = null, public val y: Int? = null) {
 
@@ -82,7 +82,7 @@ private constructor(public val x: Int? = null, public val y: Int? = null) {
      * early as June 2026. As a replacement, you can
      * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
      */
-    @Deprecated("All Imagen models are deprecated.")
+    @Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
     @JvmStatic
     public fun fromCoordinate(x: Int, y: Int): ImagenImagePlacement {
       return ImagenImagePlacement(x, y)
diff --git a/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenInlineImage.kt b/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenInlineImage.kt
index bc751c83474..e25b4e9b269 100644
--- a/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenInlineImage.kt
+++ b/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenInlineImage.kt
@@ -33,7 +33,7 @@ import kotlinx.serialization.Serializable
  * as June 2026. As a replacement, you can
  * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
  */
-@Deprecated("All Imagen models are deprecated.")
+@Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
 public class ImagenInlineImage
 internal constructor(
   public val data: ByteArray,
@@ -47,7 +47,7 @@ internal constructor(
    * early as June 2026. As a replacement, you can
    * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
    */
-  @Deprecated("All Imagen models are deprecated.")
+  @Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
   public fun asBitmap(): Bitmap {
     return BitmapFactory.decodeByteArray(data, 0, data.size)
   }
@@ -67,7 +67,7 @@ internal constructor(
  * as June 2026. As a replacement, you can
  * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
  */
-@Deprecated("All Imagen models are deprecated.")
+@Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
 @PublicPreviewAPI
 public fun Bitmap.toImagenInlineImage(): ImagenInlineImage {
   val byteArrayOutputStream = ByteArrayOutputStream()
diff --git a/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenPersonFilterLevel.kt b/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenPersonFilterLevel.kt
index 122dbd247e5..bc96d5d268d 100644
--- a/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenPersonFilterLevel.kt
+++ b/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenPersonFilterLevel.kt
@@ -23,7 +23,7 @@ package com.google.firebase.ai.type
  * as June 2026. As a replacement, you can
  * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
  */
-@Deprecated("All Imagen models are deprecated.")
+@Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
 public class ImagenPersonFilterLevel private constructor(internal val internalVal: String) {
   public companion object {
     /**
diff --git a/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenReferenceImage.kt b/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenReferenceImage.kt
index 1bbd64c47e6..433ef63d3d8 100644
--- a/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenReferenceImage.kt
+++ b/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenReferenceImage.kt
@@ -30,7 +30,7 @@ import kotlinx.serialization.Serializable
  * as June 2026. As a replacement, you can
  * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
  */
-@Deprecated("All Imagen models are deprecated.")
+@Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
 @PublicPreviewAPI
 public abstract class ImagenReferenceImage
 internal constructor(
@@ -97,7 +97,7 @@ internal constructor(
  * as June 2026. As a replacement, you can
  * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
  */
-@Deprecated("All Imagen models are deprecated.")
+@Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
 @PublicPreviewAPI
 public class ImagenControlReference(
   type: ImagenControlType,
@@ -122,7 +122,7 @@ public class ImagenControlReference(
  * as June 2026. As a replacement, you can
  * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
  */
-@Deprecated("All Imagen models are deprecated.")
+@Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
 @PublicPreviewAPI
 public abstract class ImagenMaskReference
 internal constructor(maskConfig: ImagenMaskConfig, image: ImagenInlineImage? = null) :
@@ -146,7 +146,7 @@ internal constructor(maskConfig: ImagenMaskConfig, image: ImagenInlineImage? = n
      * early as June 2026. As a replacement, you can
      * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
      */
-    @Deprecated("All Imagen models are deprecated.")
+    @Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
     @JvmOverloads
     @JvmStatic
     public fun generateMaskAndPadForOutpainting(
@@ -174,7 +174,7 @@ internal constructor(maskConfig: ImagenMaskConfig, image: ImagenInlineImage? = n
      * early as June 2026. As a replacement, you can
      * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
      */
-    @Deprecated("All Imagen models are deprecated.")
+    @Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
     @JvmStatic
     public fun generateMaskAndPadForOutpainting(
       image: ImagenInlineImage,
@@ -246,7 +246,7 @@ internal constructor(maskConfig: ImagenMaskConfig, image: ImagenInlineImage? = n
  * as June 2026. As a replacement, you can
  * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
  */
-@Deprecated("All Imagen models are deprecated.")
+@Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
 @PublicPreviewAPI
 public class ImagenBackgroundMask(dilation: Double? = null) :
   ImagenMaskReference(maskConfig = ImagenMaskConfig(ImagenMaskMode.BACKGROUND, dilation)) {}
@@ -261,7 +261,7 @@ public class ImagenBackgroundMask(dilation: Double? = null) :
  * as June 2026. As a replacement, you can
  * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
  */
-@Deprecated("All Imagen models are deprecated.")
+@Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
 @PublicPreviewAPI
 public class ImagenForegroundMask(dilation: Double? = null) :
   ImagenMaskReference(maskConfig = ImagenMaskConfig(ImagenMaskMode.FOREGROUND, dilation)) {}
@@ -278,7 +278,7 @@ public class ImagenForegroundMask(dilation: Double? = null) :
  * as June 2026. As a replacement, you can
  * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
  */
-@Deprecated("All Imagen models are deprecated.")
+@Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
 @PublicPreviewAPI
 public class ImagenRawMask(mask: ImagenInlineImage, dilation: Double? = null) :
   ImagenMaskReference(
@@ -299,7 +299,7 @@ public class ImagenRawMask(mask: ImagenInlineImage, dilation: Double? = null) :
  * as June 2026. As a replacement, you can
  * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
  */
-@Deprecated("All Imagen models are deprecated.")
+@Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
 @PublicPreviewAPI
 public class ImagenSemanticMask(classes: List<Int>, dilation: Double? = null) :
   ImagenMaskReference(maskConfig = ImagenMaskConfig(ImagenMaskMode.SEMANTIC, dilation, classes)) {}
@@ -312,7 +312,7 @@ public class ImagenSemanticMask(classes: List<Int>, dilation: Double? = null) :
  * as June 2026. As a replacement, you can
  * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
  */
-@Deprecated("All Imagen models are deprecated.")
+@Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
 @PublicPreviewAPI
 public class ImagenRawImage(image: ImagenInlineImage) : ImagenReferenceImage(image = image) {}
 
@@ -326,7 +326,7 @@ public class ImagenRawImage(image: ImagenInlineImage) : ImagenReferenceImage(ima
  * as June 2026. As a replacement, you can
  * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
  */
-@Deprecated("All Imagen models are deprecated.")
+@Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
 @PublicPreviewAPI
 public class ImagenStyleReference(
   image: ImagenInlineImage,
@@ -350,7 +350,7 @@ public class ImagenStyleReference(
  * as June 2026. As a replacement, you can
  * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
  */
-@Deprecated("All Imagen models are deprecated.")
+@Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
 @PublicPreviewAPI
 public class ImagenSubjectReference(
   image: ImagenInlineImage,
diff --git a/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenSafetyFilterLevel.kt b/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenSafetyFilterLevel.kt
index 39ee932c3dd..acd48d2669c 100644
--- a/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenSafetyFilterLevel.kt
+++ b/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenSafetyFilterLevel.kt
@@ -23,7 +23,7 @@ package com.google.firebase.ai.type
  * as June 2026. As a replacement, you can
  * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
  */
-@Deprecated("All Imagen models are deprecated.")
+@Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
 public class ImagenSafetyFilterLevel private constructor(internal val internalVal: String) {
   public companion object {
     /** Strongest filtering level, most strict blocking. */
diff --git a/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenSubjectReferenceType.kt b/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenSubjectReferenceType.kt
index b8b54f03f73..8457bc8ab4d 100644
--- a/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenSubjectReferenceType.kt
+++ b/ai-logic/firebase-ai/src/main/kotlin/com/google/firebase/ai/type/ImagenSubjectReferenceType.kt
@@ -22,7 +22,7 @@ package com.google.firebase.ai.type
  * as June 2026. As a replacement, you can
  * [migrate your apps to use Gemini Image models (the 'Nano Banana' models)](https://firebase.google.com/docs/ai-logic/imagen-models-migration)
  */
-@Deprecated("All Imagen models are deprecated.")
+@Deprecated("All Imagen models are deprecated. Migrate your apps to use Gemini Image Models")
 public class ImagenSubjectReferenceType private constructor(internal val value: String) {
 
   public companion object {