Merge 7952b0d3d6 into a9ab2b62da

comfy_api_nodes/nodes_bytedance.py

@@ -561,9 +561,14 @@ class ByteDanceSeedreamNode(IO.ComfyNode):
     def define_schema(cls):
         return IO.Schema(
             node_id="ByteDanceSeedreamNode",
-            display_name="ByteDance Seedream 4.5 & 5.0",
+            display_name="ByteDance Seedream 4.5 & 5.0 (legacy)",
             category="partner/image/ByteDance",
-            description="Unified text-to-image generation and precise single-sentence editing at up to 4K resolution.",
+            description=(
+                "Unified text-to-image generation and precise single-sentence editing at up to 4K resolution. "
+                "This class name is historical and is kept only for compatibility with existing workflows; "
+                "it supports the current models, "
+                "so prefer the ByteDanceSeedreamNodeV2 ('ByteDance Seedream 4.5 & 5.0') node for new workflows."
+            ),
             inputs=[
                 IO.Combo.Input(
                     "model",

comfy_api_nodes/nodes_gemini.py

@@ -430,11 +430,14 @@ class GeminiNode(IO.ComfyNode):
     def define_schema(cls):
         return IO.Schema(
             node_id="GeminiNode",
-            display_name="Google Gemini",
+            display_name="Google Gemini (legacy)",
             category="partner/text/Gemini",
             description="Generate text responses with Google's Gemini AI model. "
             "You can provide multiple types of inputs (text, images, audio, video) "
-            "as context for generating more relevant and meaningful responses.",
+            "as context for generating more relevant and meaningful responses. "
+            "This class name is historical and is kept only for compatibility with existing workflows; "
+            "it supports the current Gemini models, "
+            "so prefer the GeminiNodeV2 ('Google Gemini') node for new workflows.",
             inputs=[
                 IO.String.Input(
                     "prompt",
@@ -446,11 +449,11 @@ class GeminiNode(IO.ComfyNode):
                 IO.Combo.Input(
                     "model",
                     options=[
+                        "gemini-3-1-pro",
+                        "gemini-3-1-flash-lite",
                         "gemini-2.5-pro",
                         "gemini-2.5-flash",
                         "gemini-3-pro-preview",
-                        "gemini-3-1-pro",
-                        "gemini-3-1-flash-lite",
                     ],
                     default="gemini-3-1-pro",
                     tooltip="The Gemini model to use for generating responses.",
@@ -1160,9 +1163,14 @@ class GeminiNanoBanana2(IO.ComfyNode):
     def define_schema(cls):
         return IO.Schema(
             node_id="GeminiNanoBanana2",
-            display_name="Nano Banana 2",
+            display_name="Nano Banana 2 (legacy)",
             category="partner/image/Gemini",
-            description="Generate or edit images synchronously via Google Vertex API.",
+            description=(
+                "Generate or edit images synchronously via Google Vertex API. "
+                "This class name is historical and is kept only for compatibility with existing workflows; "
+                "it supports the current models, "
+                "so prefer the GeminiNanoBanana2V2 ('Nano Banana 2') node for new workflows."
+            ),
             inputs=[
                 IO.String.Input(
                     "prompt",

comfy_api_nodes/nodes_grok.py

@@ -338,9 +338,14 @@ class GrokImageEditNode(IO.ComfyNode):
     def define_schema(cls):
         return IO.Schema(
             node_id="GrokImageEditNode",
-            display_name="Grok Image Edit",
+            display_name="Grok Image Edit (legacy)",
             category="partner/image/Grok",
-            description="Modify an existing image based on a text prompt",
+            description=(
+                "Modify an existing image based on a text prompt. "
+                "This class name is historical and is kept only for compatibility with existing workflows; "
+                "it supports the current models, "
+                "so prefer the GrokImageEditNodeV2 ('Grok Image Edit') node for new workflows."
+            ),
             inputs=[
                 IO.Combo.Input(
                     "model",

comfy_api_nodes/nodes_openai.py

@@ -370,9 +370,14 @@ class OpenAIGPTImage1(IO.ComfyNode):
     def define_schema(cls):
         return IO.Schema(
             node_id="OpenAIGPTImage1",
-            display_name="OpenAI GPT Image 2",
+            display_name="OpenAI GPT Image 2 (legacy)",
             category="partner/image/OpenAI",
-            description="Generates images synchronously via OpenAI's GPT Image endpoint.",
+            description=(
+                "Generates images synchronously via OpenAI's GPT Image endpoint. "
+                "This class name is historical and is kept only for compatibility with existing workflows; "
+                "the node is not limited to GPT Image 1 and defaults to the current gpt-image-2 model, "
+                "so prefer the OpenAIGPTImageNodeV2 ('OpenAI GPT Image 2') node for new workflows."
+            ),
             is_deprecated=True,
             inputs=[
                 IO.String.Input(
@@ -446,7 +451,7 @@ class OpenAIGPTImage1(IO.ComfyNode):
                 ),
                 IO.Combo.Input(
                     "model",
-                    options=["gpt-image-1", "gpt-image-1.5", "gpt-image-2"],
+                    options=["gpt-image-2", "gpt-image-1.5", "gpt-image-1"],
                     default="gpt-image-2",
                     optional=True,
                 ),