Merge branch 'master' into Import-blueprint

Support loading the alpha channel of videos. (#13564 )
Not exposed in nodes yet.
2026-05-07 10:47:58 +08:00 · 2026-04-26 22:40:40 +08:00 · 2026-04-25 21:02:58 -04:00 · 2026-04-24 17:21:39 -07:00 · 2026-04-24 16:46:10 -04:00 · 2026-04-24 06:54:10 -07:00
26 changed files with 33253 additions and 1093 deletions
--- a/.gitignore
+++ b/.gitignore
@ -21,6 +21,5 @@ venv*/
 *.log
 web_custom_versions/
 .DS_Store
-openapi.yaml
 filtered-openapi.yaml
 uv.lock
--- a/blueprints/Crop
+++ b/blueprints/Crop
--- a/blueprints/Crop
+++ b/blueprints/Crop
--- a/(Z-Image-Turbo).json
+++ b/(Z-Image-Turbo).json
@ -160,7 +160,7 @@
        },
        "revision": 0,
        "config": {},
-        "name": "local-Depth to Image (Z-Image-Turbo)",
+        "name": "Depth to Image (Z-Image-Turbo)",
        "inputNode": {
          "id": -10,
          "bounding": [
@ -2482,4 +2482,4 @@
    "VHS_KeepIntermediate": true
  },
  "version": 0.4
-}
+}
--- a/blueprints/Depth
+++ b/blueprints/Depth
@ -261,7 +261,7 @@
        },
        "revision": 0,
        "config": {},
-        "name": "local-Depth to Video (LTX 2.0)",
+        "name": "Depth to Video (LTX 2.0)",
        "inputNode": {
          "id": -10,
          "bounding": [
@ -5208,4 +5208,4 @@
    "workflowRendererVersion": "LG"
  },
  "version": 0.4
-}
+}
--- a/blueprints/First-Last-Frame
+++ b/blueprints/First-Last-Frame
--- a/blueprints/Image
+++ b/blueprints/Image
--- a/blueprints/Image
+++ b/blueprints/Image
@ -128,7 +128,7 @@
        },
        "revision": 0,
        "config": {},
-        "name": "local-Image Edit (Flux.2 Klein 4B)",
+        "name": "Image Edit (Flux.2 Klein 4B)",
        "inputNode": {
          "id": -10,
          "bounding": [
@ -1837,4 +1837,4 @@
    }
  },
  "version": 0.4
-}
+}
--- a/blueprints/Image
+++ b/blueprints/Image
--- a/blueprints/Image
+++ b/blueprints/Image
--- a/(Qwen-image).json
+++ b/(Qwen-image).json
@ -124,7 +124,7 @@
        },
        "revision": 0,
        "config": {},
-        "name": "local-Image Inpainting (Qwen-image)",
+        "name": "Image Inpainting (Qwen-image)",
        "inputNode": {
          "id": -10,
          "bounding": [
@ -1923,4 +1923,4 @@
    "workflowRendererVersion": "LG"
  },
  "version": 0.4
-}
+}
--- a/(Qwen-Image).json
+++ b/(Qwen-Image).json
@ -204,7 +204,7 @@
        },
        "revision": 0,
        "config": {},
-        "name": "local-Image Outpainting (Qwen-Image)",
+        "name": "Image Outpainting (Qwen-Image)",
        "inputNode": {
          "id": -10,
          "bounding": [
@ -2749,4 +2749,4 @@
    }
  },
  "version": 0.4
-}
+}
--- a/Layers(Qwen-Image-Layered).json
+++ b/Layers(Qwen-Image-Layered).json
@ -1,15 +1,14 @@
 {
-  "id": "1a761372-7c82-4016-b9bf-fa285967e1e9",
  "revision": 0,
-  "last_node_id": 83,
+  "last_node_id": 176,
  "last_link_id": 0,
  "nodes": [
    {
-      "id": 83,
-      "type": "f754a936-daaf-4b6e-9658-41fdc54d301d",
+      "id": 176,
+      "type": "2d2e3c8e-53b3-4618-be52-6d1d99382f0e",
      "pos": [
-        61.999827823554256,
-        153.3332507624185
+        -1150,
+        200
      ],
      "size": [
        400,
@ -56,6 +55,38 @@
            "name": "layers"
          },
          "link": null
+        },
+        {
+          "name": "seed",
+          "type": "INT",
+          "widget": {
+            "name": "seed"
+          },
+          "link": null
+        },
+        {
+          "name": "unet_name",
+          "type": "COMBO",
+          "widget": {
+            "name": "unet_name"
+          },
+          "link": null
+        },
+        {
+          "name": "clip_name",
+          "type": "COMBO",
+          "widget": {
+            "name": "clip_name"
+          },
+          "link": null
+        },
+        {
+          "name": "vae_name",
+          "type": "COMBO",
+          "widget": {
+            "name": "vae_name"
+          },
+          "link": null
        }
      ],
      "outputs": [
@ -66,28 +97,41 @@
          "links": []
        }
      ],
+      "title": "Image to Layers (Qwen-Image-Layered)",
      "properties": {
        "proxyWidgets": [
          [
-            "-1",
+            "6",
            "text"
          ],
          [
-            "-1",
+            "3",
            "steps"
          ],
          [
-            "-1",
+            "3",
            "cfg"
          ],
          [
-            "-1",
+            "83",
            "layers"
          ],
          [
            "3",
            "seed"
          ],
+          [
+            "37",
+            "unet_name"
+          ],
+          [
+            "38",
+            "clip_name"
+          ],
+          [
+            "39",
+            "vae_name"
+          ],
          [
            "3",
            "control_after_generate"
@ -95,6 +139,11 @@
        ],
        "cnr_id": "comfy-core",
        "ver": "0.5.1",
+        "ue_properties": {
+          "widget_ue_connectable": {},
+          "input_ue_unconnectable": {},
+          "version": "7.7"
+        },
        "enableTabs": false,
        "tabWidth": 65,
        "tabXOffset": 10,
@ -103,25 +152,20 @@
        "secondTabOffset": 80,
        "secondTabWidth": 65
      },
-      "widgets_values": [
-        "",
-        20,
-        2.5,
-        2
-      ]
+      "widgets_values": []
    }
  ],
  "links": [],
-  "groups": [],
+  "version": 0.4,
  "definitions": {
    "subgraphs": [
      {
-        "id": "f754a936-daaf-4b6e-9658-41fdc54d301d",
+        "id": "2d2e3c8e-53b3-4618-be52-6d1d99382f0e",
        "version": 1,
        "state": {
-          "lastGroupId": 3,
-          "lastNodeId": 83,
-          "lastLinkId": 159,
+          "lastGroupId": 8,
+          "lastNodeId": 176,
+          "lastLinkId": 380,
          "lastRerouteId": 0
        },
        "revision": 0,
@ -130,10 +174,10 @@
        "inputNode": {
          "id": -10,
          "bounding": [
-            -510,
-            523,
+            -720,
+            720,
            120,
-            140
+            220
          ]
        },
        "outputNode": {
@ -156,8 +200,8 @@
            ],
            "localized_name": "image",
            "pos": [
-              -410,
-              543
+              -620,
+              740
            ]
          },
          {
@ -168,8 +212,8 @@
              150
            ],
            "pos": [
-              -410,
-              563
+              -620,
+              760
            ]
          },
          {
@ -180,8 +224,8 @@
              153
            ],
            "pos": [
-              -410,
-              583
+              -620,
+              780
            ]
          },
          {
@ -192,8 +236,8 @@
              154
            ],
            "pos": [
-              -410,
-              603
+              -620,
+              800
            ]
          },
          {
@ -204,8 +248,56 @@
              159
            ],
            "pos": [
-              -410,
-              623
+              -620,
+              820
+            ]
+          },
+          {
+            "id": "9f76338b-f4ca-4bb3-b61a-57b3f233061e",
+            "name": "seed",
+            "type": "INT",
+            "linkIds": [
+              377
+            ],
+            "pos": [
+              -620,
+              840
+            ]
+          },
+          {
+            "id": "8d0422d5-5eee-4f7e-9817-dc613cc62eca",
+            "name": "unet_name",
+            "type": "COMBO",
+            "linkIds": [
+              378
+            ],
+            "pos": [
+              -620,
+              860
+            ]
+          },
+          {
+            "id": "552eece2-a735-4d00-ae78-ded454622bc1",
+            "name": "clip_name",
+            "type": "COMBO",
+            "linkIds": [
+              379
+            ],
+            "pos": [
+              -620,
+              880
+            ]
+          },
+          {
+            "id": "1e6d141c-d0f9-4a2b-895c-b6780e57cfa0",
+            "name": "vae_name",
+            "type": "COMBO",
+            "linkIds": [
+              380
+            ],
+            "pos": [
+              -620,
+              900
            ]
          }
        ],
@ -231,14 +323,14 @@
            "type": "CLIPLoader",
            "pos": [
              -320,
-              310
+              360
            ],
            "size": [
-              346.7470703125,
-              106
+              350,
+              150
            ],
            "flags": {},
-            "order": 0,
+            "order": 5,
            "mode": 0,
            "inputs": [
              {
@ -248,7 +340,7 @@
                "widget": {
                  "name": "clip_name"
                },
-                "link": null
+                "link": 379
              },
              {
                "localized_name": "type",
@ -283,9 +375,14 @@
              }
            ],
            "properties": {
-              "Node name for S&R": "CLIPLoader",
              "cnr_id": "comfy-core",
              "ver": "0.5.1",
+              "ue_properties": {
+                "widget_ue_connectable": {},
+                "input_ue_unconnectable": {},
+                "version": "7.7"
+              },
+              "Node name for S&R": "CLIPLoader",
              "models": [
                {
                  "name": "qwen_2.5_vl_7b_fp8_scaled.safetensors",
@ -312,14 +409,14 @@
            "type": "VAELoader",
            "pos": [
              -320,
-              460
+              580
            ],
            "size": [
-              346.7470703125,
-              58
+              350,
+              110
            ],
            "flags": {},
-            "order": 1,
+            "order": 6,
            "mode": 0,
            "inputs": [
              {
@ -329,7 +426,7 @@
                "widget": {
                  "name": "vae_name"
                },
-                "link": null
+                "link": 380
              }
            ],
            "outputs": [
@ -345,9 +442,14 @@
              }
            ],
            "properties": {
-              "Node name for S&R": "VAELoader",
              "cnr_id": "comfy-core",
              "ver": "0.5.1",
+              "ue_properties": {
+                "widget_ue_connectable": {},
+                "input_ue_unconnectable": {},
+                "version": "7.7"
+              },
+              "Node name for S&R": "VAELoader",
              "models": [
                {
                  "name": "qwen_image_layered_vae.safetensors",
@ -375,11 +477,11 @@
              420
            ],
            "size": [
-              425.27801513671875,
-              180.6060791015625
+              430,
+              190
            ],
            "flags": {},
-            "order": 3,
+            "order": 2,
            "mode": 0,
            "inputs": [
              {
@ -411,9 +513,14 @@
            ],
            "title": "CLIP Text Encode (Negative Prompt)",
            "properties": {
-              "Node name for S&R": "CLIPTextEncode",
              "cnr_id": "comfy-core",
              "ver": "0.5.1",
+              "ue_properties": {
+                "widget_ue_connectable": {},
+                "input_ue_unconnectable": {},
+                "version": "7.7"
+              },
+              "Node name for S&R": "CLIPTextEncode",
              "enableTabs": false,
              "tabWidth": 65,
              "tabXOffset": 10,
@ -432,12 +539,12 @@
            "id": 70,
            "type": "ReferenceLatent",
            "pos": [
-              330,
-              670
+              140,
+              700
            ],
            "size": [
-              204.1666717529297,
-              46
+              210,
+              50
            ],
            "flags": {
              "collapsed": true
@ -470,9 +577,14 @@
              }
            ],
            "properties": {
-              "Node name for S&R": "ReferenceLatent",
              "cnr_id": "comfy-core",
              "ver": "0.5.1",
+              "ue_properties": {
+                "widget_ue_connectable": {},
+                "input_ue_unconnectable": {},
+                "version": "7.7"
+              },
+              "Node name for S&R": "ReferenceLatent",
              "enableTabs": false,
              "tabWidth": 65,
              "tabXOffset": 10,
@ -480,19 +592,18 @@
              "secondTabText": "Send Back",
              "secondTabOffset": 80,
              "secondTabWidth": 65
-            },
-            "widgets_values": []
+            }
          },
          {
            "id": 69,
            "type": "ReferenceLatent",
            "pos": [
-              330,
-              710
+              160,
+              820
            ],
            "size": [
-              204.1666717529297,
-              46
+              210,
+              50
            ],
            "flags": {
              "collapsed": true
@ -525,9 +636,14 @@
              }
            ],
            "properties": {
-              "Node name for S&R": "ReferenceLatent",
              "cnr_id": "comfy-core",
              "ver": "0.5.1",
+              "ue_properties": {
+                "widget_ue_connectable": {},
+                "input_ue_unconnectable": {},
+                "version": "7.7"
+              },
+              "Node name for S&R": "ReferenceLatent",
              "enableTabs": false,
              "tabWidth": 65,
              "tabXOffset": 10,
@ -535,8 +651,7 @@
              "secondTabText": "Send Back",
              "secondTabOffset": 80,
              "secondTabWidth": 65
-            },
-            "widgets_values": []
+            }
          },
          {
            "id": 66,
@ -547,10 +662,10 @@
            ],
            "size": [
              270,
-              58
+              110
            ],
            "flags": {},
-            "order": 4,
+            "order": 7,
            "mode": 0,
            "inputs": [
              {
@ -580,9 +695,14 @@
              }
            ],
            "properties": {
-              "Node name for S&R": "ModelSamplingAuraFlow",
              "cnr_id": "comfy-core",
              "ver": "0.5.1",
+              "ue_properties": {
+                "widget_ue_connectable": {},
+                "input_ue_unconnectable": {},
+                "version": "7.7"
+              },
+              "Node name for S&R": "ModelSamplingAuraFlow",
              "enableTabs": false,
              "tabWidth": 65,
              "tabXOffset": 10,
@ -600,11 +720,11 @@
            "type": "LatentCutToBatch",
            "pos": [
              830,
-              160
+              140
            ],
            "size": [
              270,
-              82
+              140
            ],
            "flags": {},
            "order": 11,
@ -646,9 +766,14 @@
              }
            ],
            "properties": {
-              "Node name for S&R": "LatentCutToBatch",
              "cnr_id": "comfy-core",
              "ver": "0.5.1",
+              "ue_properties": {
+                "widget_ue_connectable": {},
+                "input_ue_unconnectable": {},
+                "version": "7.7"
+              },
+              "Node name for S&R": "LatentCutToBatch",
              "enableTabs": false,
              "tabWidth": 65,
              "tabXOffset": 10,
@ -666,12 +791,12 @@
            "id": 71,
            "type": "VAEEncode",
            "pos": [
-              100,
-              690
+              -280,
+              780
            ],
            "size": [
-              140,
-              46
+              230,
+              100
            ],
            "flags": {
              "collapsed": false
@ -704,9 +829,14 @@
              }
            ],
            "properties": {
-              "Node name for S&R": "VAEEncode",
              "cnr_id": "comfy-core",
              "ver": "0.5.1",
+              "ue_properties": {
+                "widget_ue_connectable": {},
+                "input_ue_unconnectable": {},
+                "version": "7.7"
+              },
+              "Node name for S&R": "VAEEncode",
              "enableTabs": false,
              "tabWidth": 65,
              "tabXOffset": 10,
@ -714,24 +844,23 @@
              "secondTabText": "Send Back",
              "secondTabOffset": 80,
              "secondTabWidth": 65
-            },
-            "widgets_values": []
+            }
          },
          {
            "id": 8,
            "type": "VAEDecode",
            "pos": [
              850,
-              310
+              370
            ],
            "size": [
              210,
-              46
+              50
            ],
            "flags": {
              "collapsed": true
            },
-            "order": 7,
+            "order": 3,
            "mode": 0,
            "inputs": [
              {
@ -759,9 +888,14 @@
              }
            ],
            "properties": {
-              "Node name for S&R": "VAEDecode",
              "cnr_id": "comfy-core",
              "ver": "0.5.1",
+              "ue_properties": {
+                "widget_ue_connectable": {},
+                "input_ue_unconnectable": {},
+                "version": "7.7"
+              },
+              "Node name for S&R": "VAEDecode",
              "enableTabs": false,
              "tabWidth": 65,
              "tabXOffset": 10,
@ -769,8 +903,7 @@
              "secondTabText": "Send Back",
              "secondTabOffset": 80,
              "secondTabWidth": 65
-            },
-            "widgets_values": []
+            }
          },
          {
            "id": 6,
@ -780,11 +913,11 @@
              180
            ],
            "size": [
-              422.84503173828125,
-              164.31304931640625
+              430,
+              170
            ],
            "flags": {},
-            "order": 6,
+            "order": 1,
            "mode": 0,
            "inputs": [
              {
@ -816,9 +949,14 @@
            ],
            "title": "CLIP Text Encode (Positive Prompt)",
            "properties": {
-              "Node name for S&R": "CLIPTextEncode",
              "cnr_id": "comfy-core",
              "ver": "0.5.1",
+              "ue_properties": {
+                "widget_ue_connectable": {},
+                "input_ue_unconnectable": {},
+                "version": "7.7"
+              },
+              "Node name for S&R": "CLIPTextEncode",
              "enableTabs": false,
              "tabWidth": 65,
              "tabXOffset": 10,
@ -838,14 +976,14 @@
            "type": "KSampler",
            "pos": [
              530,
-              280
+              340
            ],
            "size": [
              270,
              400
            ],
            "flags": {},
-            "order": 5,
+            "order": 0,
            "mode": 0,
            "inputs": [
              {
@ -879,7 +1017,7 @@
                "widget": {
                  "name": "seed"
                },
-                "link": null
+                "link": 377
              },
              {
                "localized_name": "steps",
@ -939,9 +1077,14 @@
              }
            ],
            "properties": {
-              "Node name for S&R": "KSampler",
              "cnr_id": "comfy-core",
              "ver": "0.5.1",
+              "ue_properties": {
+                "widget_ue_connectable": {},
+                "input_ue_unconnectable": {},
+                "version": "7.7"
+              },
+              "Node name for S&R": "KSampler",
              "enableTabs": false,
              "tabWidth": 65,
              "tabXOffset": 10,
@ -964,12 +1107,12 @@
            "id": 78,
            "type": "GetImageSize",
            "pos": [
-              80,
-              790
+              -280,
+              930
            ],
            "size": [
-              210,
-              136
+              230,
+              140
            ],
            "flags": {},
            "order": 12,
@ -1007,9 +1150,14 @@
              }
            ],
            "properties": {
-              "Node name for S&R": "GetImageSize",
              "cnr_id": "comfy-core",
              "ver": "0.5.1",
+              "ue_properties": {
+                "widget_ue_connectable": {},
+                "input_ue_unconnectable": {},
+                "version": "7.7"
+              },
+              "Node name for S&R": "GetImageSize",
              "enableTabs": false,
              "tabWidth": 65,
              "tabXOffset": 10,
@ -1017,23 +1165,23 @@
              "secondTabText": "Send Back",
              "secondTabOffset": 80,
              "secondTabWidth": 65
-            },
-            "widgets_values": []
+            }
          },
          {
            "id": 83,
            "type": "EmptyQwenImageLayeredLatentImage",
            "pos": [
-              320,
-              790
+              -280,
+              1120
            ],
            "size": [
-              330.9341796875,
-              130
+              340,
+              200
            ],
            "flags": {},
            "order": 13,
            "mode": 0,
+            "showAdvanced": true,
            "inputs": [
              {
                "localized_name": "width",
@ -1083,9 +1231,14 @@
              }
            ],
            "properties": {
-              "Node name for S&R": "EmptyQwenImageLayeredLatentImage",
              "cnr_id": "comfy-core",
              "ver": "0.5.1",
+              "ue_properties": {
+                "widget_ue_connectable": {},
+                "input_ue_unconnectable": {},
+                "version": "7.7"
+              },
+              "Node name for S&R": "EmptyQwenImageLayeredLatentImage",
              "enableTabs": false,
              "tabWidth": 65,
              "tabXOffset": 10,
@ -1109,11 +1262,11 @@
              180
            ],
            "size": [
-              346.7470703125,
-              82
+              350,
+              110
            ],
            "flags": {},
-            "order": 2,
+            "order": 4,
            "mode": 0,
            "inputs": [
              {
@ -1123,7 +1276,7 @@
                "widget": {
                  "name": "unet_name"
                },
-                "link": null
+                "link": 378
              },
              {
                "localized_name": "weight_dtype",
@ -1147,9 +1300,14 @@
              }
            ],
            "properties": {
-              "Node name for S&R": "UNETLoader",
              "cnr_id": "comfy-core",
              "ver": "0.5.1",
+              "ue_properties": {
+                "widget_ue_connectable": {},
+                "input_ue_unconnectable": {},
+                "version": "7.7"
+              },
+              "Node name for S&R": "UNETLoader",
              "models": [
                {
                  "name": "qwen_image_layered_bf16.safetensors",
@ -1191,8 +1349,8 @@
            "bounding": [
              -330,
              110,
-              366.7470703125,
-              421.6
+              370,
+              610
            ],
            "color": "#3f789e",
            "font_size": 24,
@ -1391,6 +1549,38 @@
            "target_id": 83,
            "target_slot": 2,
            "type": "INT"
+          },
+          {
+            "id": 377,
+            "origin_id": -10,
+            "origin_slot": 5,
+            "target_id": 3,
+            "target_slot": 4,
+            "type": "INT"
+          },
+          {
+            "id": 378,
+            "origin_id": -10,
+            "origin_slot": 6,
+            "target_id": 37,
+            "target_slot": 0,
+            "type": "COMBO"
+          },
+          {
+            "id": 379,
+            "origin_id": -10,
+            "origin_slot": 7,
+            "target_id": 38,
+            "target_slot": 0,
+            "type": "COMBO"
+          },
+          {
+            "id": 380,
+            "origin_id": -10,
+            "origin_slot": 8,
+            "target_id": 39,
+            "target_slot": 0,
+            "type": "COMBO"
          }
        ],
        "extra": {
@ -1400,7 +1590,6 @@
      }
    ]
  },
-  "config": {},
  "extra": {
    "ds": {
      "scale": 1.14,
@ -1409,7 +1598,6 @@
        6.855893974423647
      ]
    },
-    "workflowRendererVersion": "LG"
-  },
-  "version": 0.4
-}
+    "ue_links": []
+  }
+}
--- a/blueprints/Image
+++ b/blueprints/Image
--- a/blueprints/Pose
+++ b/blueprints/Pose
--- a/blueprints/Text
+++ b/blueprints/Text
--- a/blueprints/Text
+++ b/blueprints/Text
--- a/blueprints/Text
+++ b/blueprints/Text
--- a/blueprints/Text
+++ b/blueprints/Text
--- a/(Qwen-Image).json
+++ b/(Qwen-Image).json
--- a/blueprints/Text
+++ b/blueprints/Text
--- a/comfy_api/latest/_input_impl/video_types.py
+++ b/comfy_api/latest/_input_impl/video_types.py
@ -240,19 +240,34 @@ class VideoFromFile(VideoInput):
            start_time = self.__start_time
        # Get video frames
        frames = []
+        alphas = None
        start_pts = int(start_time / video_stream.time_base)
        end_pts = int((start_time + self.__duration) / video_stream.time_base)
        container.seek(start_pts, stream=video_stream)
+        image_format = 'gbrpf32le'
        for frame in container.decode(video_stream):
+            if alphas is None:
+                for comp in frame.format.components:
+                    if comp.is_alpha:
+                        alphas = []
+                        image_format = 'gbrapf32le'
+                        break
+
            if frame.pts < start_pts:
                continue
            if self.__duration and frame.pts >= end_pts:
                break
-            img = frame.to_ndarray(format='rgb24')  # shape: (H, W, 3)
-            img = torch.from_numpy(img) / 255.0  # shape: (H, W, 3)
-            frames.append(img)

-        images = torch.stack(frames) if len(frames) > 0 else torch.zeros(0, 3, 0, 0)
+            img = frame.to_ndarray(format=image_format)  # shape: (H, W, 4)
+            if alphas is None:
+                frames.append(torch.from_numpy(img))
+            else:
+                frames.append(torch.from_numpy(img[..., :-1]))
+                alphas.append(torch.from_numpy(img[..., -1:]))
+
+        images = torch.stack(frames) if len(frames) > 0 else torch.zeros(0, 0, 0, 3)
+        if alphas is not None:
+            alphas = torch.stack(alphas) if len(alphas) > 0 else torch.zeros(0, 0, 0, 1)

        # Get frame rate
        frame_rate = Fraction(video_stream.average_rate) if video_stream.average_rate else Fraction(1)
@ -295,7 +310,7 @@ class VideoFromFile(VideoInput):
                })

        metadata = container.metadata
-        return VideoComponents(images=images, audio=audio, frame_rate=frame_rate, metadata=metadata)
+        return VideoComponents(images=images, alpha=alphas, audio=audio, frame_rate=frame_rate, metadata=metadata)

    def get_components(self) -> VideoComponents:
        if isinstance(self.__file, io.BytesIO):
--- a/comfy_api/latest/_util/video_types.py
+++ b/comfy_api/latest/_util/video_types.py
@ -3,7 +3,7 @@ from dataclasses import dataclass
 from enum import Enum
 from fractions import Fraction
 from typing import Optional
-from .._input import ImageInput, AudioInput
+from .._input import ImageInput, AudioInput, MaskInput

 class VideoCodec(str, Enum):
    AUTO = "auto"
@ -48,5 +48,4 @@ class VideoComponents:
    frame_rate: Fraction
    audio: Optional[AudioInput] = None
    metadata: Optional[dict] = None
-
-
+    alpha: Optional[MaskInput] = None
--- a/comfy_api_nodes/nodes_sora.py
+++ b/comfy_api_nodes/nodes_sora.py
@ -33,9 +33,13 @@ class OpenAIVideoSora2(IO.ComfyNode):
    def define_schema(cls):
        return IO.Schema(
            node_id="OpenAIVideoSora2",
-            display_name="OpenAI Sora - Video",
+            display_name="OpenAI Sora - Video (Deprecated)",
            category="api node/video/Sora",
-            description="OpenAI video and audio generation.",
+            description=(
+                "OpenAI video and audio generation.\n\n"
+                "DEPRECATION NOTICE: OpenAI will stop serving the Sora v2 API in September 2026. "
+                "This node will be removed from ComfyUI at that time."
+            ),
            inputs=[
                IO.Combo.Input(
                    "model",
--- a/openapi.yaml
+++ b/openapi.yaml
--- a/requirements.txt
+++ b/requirements.txt
@ -1,4 +1,4 @@
-comfyui-frontend-package==1.42.14
+comfyui-frontend-package==1.42.15
 comfyui-workflow-templates==0.9.62
 comfyui-embedded-docs==0.4.4
 torch
Author	SHA1	Message	Date
Daxiong (Lin)	2130420a5e	Merge branch 'master' into Import-blueprint	2026-04-26 22:40:40 +08:00
comfyanonymous	df22bcd5e1	Support loading the alpha channel of videos. (#13564 ) Not exposed in nodes yet.	2026-04-25 21:02:58 -04:00
Comfy Org PR Bot	5e3f15a830	Bump comfyui-frontend-package to 1.42.15 (#13556 )	2026-04-24 17:21:39 -07:00
comfyanonymous	4304c15e9b	Properly load higher bit depth videos. (#13542 )	2026-04-24 16:46:10 -04:00
Alexander Piskun	7636599389	chore(api-nodes): add upcoming-deprecation notice to Sora nodes (#13549 )	2026-04-24 06:54:10 -07:00
Matt Miller	443074eee9	Add OpenAPI 3.1 specification for ComfyUI API (#13397 ) * Add OpenAPI 3.1 specification for ComfyUI API Adds a comprehensive OpenAPI 3.1 spec documenting all HTTP endpoints exposed by ComfyUI's server, including prompt execution, queue management, file uploads, userdata, settings, system stats, object info, assets, and internal routes. The spec was validated against the source code with adversarial review from multiple models, and passes Spectral linting with zero errors. Also removes openapi.yaml from .gitignore so the spec is tracked. * Mark /api/history endpoints as deprecated Address Jacob's review feedback on PR #13397 by explicitly marking the three /api/history operations as deprecated in the OpenAPI spec: * GET /api/history -> superseded by GET /api/jobs * POST /api/history -> superseded by /api/jobs management * GET /api/history/{prompt_id} -> superseded by GET /api/jobs/{job_id} Each operation gains deprecated: true plus a description that names the replacement. A formal sunset timeline (RFC 8594 Deprecation and RFC 8553 Sunset headers, minimum-runway policy) is being defined separately and will be applied as a follow-up. * Address Spectral lint findings in openapi.yaml - Add operation descriptions to 52 endpoints (prompt, queue, upload, view, models, userdata, settings, assets, internal, etc.) - Add schema descriptions to 22 component schemas - Add parameter descriptions to 8 path parameters that were missing them - Remove 6 unused component schemas: TaskOutput, EmbeddingsResponse, ExtensionsResponse, LogRawResponse, UserInfo, UserDataFullInfo No wire/shape changes. Reduces Spectral findings from 92 to 4. The remaining 4 are real issues (WebSocket 101 on /ws, loose error schema, and two snake_case warnings on real wire field names) and are worth addressing separately. * fix(openapi): address jtreminio oneOf review on /api/userdata Restructure the UserData response schemas to address the review feedback on the `oneOf` without a discriminator, and fix two accuracy bugs found while doing it. Changes - GET /api/userdata response: extract the inline `oneOf` to a named schema (`ListUserdataResponse`) and add the missing third variant returned when `split=true` and `full_info=false` (array of `[relative_path, ...path_components]`). Previously only two of the three actual server response shapes were described. - UserDataResponse (POST endpoints): correct the description — this schema is a single item, not a list — and point at the canonical `GetUserDataResponseFullFile` schema instead of the duplicate `UserDataResponseFull`. Also removes the malformed blank line in `UserDataResponseShort`. - Delete the now-unused `UserDataResponseFull` and `UserDataResponseShort` schemas (replaced by reuse of `GetUserDataResponseFullFile` and an inline string variant). - Add an `x-variant-selector` vendor extension to both `oneOf` sites documenting which query-parameter combination selects which branch, since a true OpenAPI `discriminator` is not applicable (the variants are type-disjoint and the selector lives in the request, not the response body). This keeps the shapes the server actually emits (no wire-breaking change) while making the selection rule explicit for SDK generators and readers. --------- Co-authored-by: guill <jacob.e.segal@gmail.com>	2026-04-23 21:00:25 -07:00
Terry Jia	2e0503780d	range type (#13322 ) Co-authored-by: guill <jacob.e.segal@gmail.com>	2026-04-23 20:51:34 -07:00
Daxiong (Lin)	35fa78be26	Merge branch 'master' into Import-blueprint	2026-04-21 10:05:10 +08:00
Jedrzej Kosinski	6039372b51	Merge branch 'master' into Import-blueprint	2026-04-20 15:37:41 -07:00
Daxiong (Lin)	aed08ac158	Merge branch 'master' into Import-blueprint	2026-04-21 01:53:38 +08:00
Daxiong (Lin)	744f6c087e	Merge branch 'master' into Import-blueprint	2026-04-17 09:43:45 +08:00
ComfyUI Wiki	c017dc7e4e	Update subgraph blueprints	2026-04-17 01:43:51 +08:00
Daxiong (Lin)	a8c758dab4	Merge branch 'master' into Import-blueprint	2026-04-17 01:02:52 +08:00
Daxiong (Lin)	1e32550575	Merge branch 'master' into Import-blueprint	2026-04-15 13:53:55 +08:00
ComfyUI Wiki	4cc0032766	Clean up image edit blueprint metadata Made-with: Cursor	2026-04-13 18:52:25 +08:00
ComfyUI Wiki	ec31322751	Fix crop blueprint split coverage Made-with: Cursor	2026-04-13 18:37:53 +08:00
ComfyUI Wiki	1f60ff8e58	Update LTX 2.0 Pose to Video	2026-04-12 22:39:20 +08:00
ComfyUI Wiki	b3226f9570	Merge branch 'Import-blueprint' of https://github.com/Comfy-Org/ComfyUI into Import-blueprint	2026-04-12 20:38:01 +08:00
ComfyUI Wiki	f9b35321b6	Update Blueprint	2026-04-12 20:37:42 +08:00
ComfyUI Wiki	4df30b0145	Update subgraph	2026-04-12 20:37:42 +08:00
ComfyUI Wiki	d2bd91eda1	Update Subgraph size	2026-04-12 20:37:42 +08:00
ComfyUI Wiki	37f22e38c6	Remove duplicate blueprint	2026-04-12 20:37:42 +08:00
ComfyUI Wiki	38ce42449f	New Subgraph blueprints	2026-04-12 20:37:42 +08:00
ComfyUI Wiki	b880b039ae	Remove local tag from subgraph name	2026-04-12 20:37:42 +08:00
ComfyUI Wiki	8a183b29bd	Update Blueprint	2026-04-12 20:36:01 +08:00
ComfyUI Wiki	75347e6237	Update subgraph	2026-04-12 20:30:10 +08:00
ComfyUI Wiki	e53556a31f	Update Subgraph size	2026-04-12 19:09:06 +08:00
ComfyUI Wiki	4cfacad7d2	Remove duplicate blueprint	2026-04-12 17:23:20 +08:00
ComfyUI Wiki	fbfab019c0	New Subgraph blueprints	2026-04-12 17:18:09 +08:00
ComfyUI Wiki	8166a155c4	Remove local tag from subgraph name	2026-04-12 10:54:27 +08:00