PJ-官方Gemini格式转换 (Bridge to Official)

This is a tiny node with a narrow, real job: ComfyUI's newer native video nodes expect a VIDEO object, not a file path. The PJ batch suite, meanwhile, passes video locations around as plain strings. PJ_LoadVideoPathForOfficial (pongjoo/ComfyUI-PJLatent, menu "PJ/批量视频") is the adapter between the two - it takes a path string in and hands out an official VIDEO object that native ComfyUI nodes will actually accept.

Hence the display name: PJ-官方Gemini格式转换 (Bridge to Official). The "Gemini" half is cryptic even by this pack's naming standards - the README is unambiguous about the actual purpose, which is converting to "ComfyUI 官方 Video 对象," i.e. the official object. "Bridge to Official" is the accurate part - this node does nothing but format conversion.

The whole interface is two slots:

• 视频绝对路径_video_path - a STRING path to an actual video file on disk.
• 官方 VIDEO 对象 - the output, typed VIDEO.

Mechanically, it calls ComfyUI's own InputImpl.VideoFromFile() from the comfy_api.latest module to construct the object, rather than reimplementing video loading. If the path doesn't exist it raises a clear 找不到视频文件 error instead of failing deep in some downstream node. That's about all there is to it - which is why you'd rather reach for it than build the bridge yourself.

Where it slots in. The batch loop pattern: BatchVideoPathProvider scans a folder and emits one path per queue run → this node converts it to a VIDEO object → official native video nodes (or any node that consumes VIDEO) do the actual frame work. Without the bridge you'd be stuck extracting frames by hand for each file or fighting type mismatches between the pack's strings and official's objects.

The catch worth knowing before you wire it: it depends on comfy_api.latest and the native VIDEO type, which only exist in recent ComfyUI builds - the video-pipeline era from roughly late 2025 onward. The source imports that module inside a try/except, so on an old ComfyUI the node will appear in your menu and only fail when you actually run it (the module never got imported, so the call errors out). The fix isn't a config tweak, it's updating ComfyUI. If you're current, this just works.

Install

Ships inside ComfyUI-PJLatent, the Chinese-authored MIT pack. ComfyUI Manager → search "ComfyUI-PJLatent", or:

cd ComfyUI/custom_nodes/
git clone https://github.com/pongjoo/ComfyUI-PJLatent.git

Restart ComfyUI. No extra Python dependencies and no model downloads - it leans entirely on whatever ComfyUI core already provides. You'll find the node under the "PJ/批量视频" menu group.

Honest verdict: it's a utility, not a headline feature. You only need it if you're mixing this pack's string-based batch video suite with official VIDEO-consuming nodes. If that's your setup, it's exactly the six lines of glue you'd otherwise have to write yourself.