Modelverse Client

Every node in the ucloud/comfyui-plugin pack (installed under the name "ComfyUl-UCloud" - yes, that typo is theirs, not yours) is a front-end for UCloud's ModelVerse cloud inference API. None of them generate anything by themselves. Every single one needs a client wired in first, and the Modelverse Client is the node that makes that client exist. Think of it as the power socket for the whole pack: no client, no API calls, nothing but ValueError messages.

Why would you want this? Because ComfyUI turns out to be a genuinely nice UI for hosted models you don't want to run locally. The KB frames the local-vs-cloud tradeoff pretty clearly - local means LoRAs, ControlNet, no censorship, no subscriptions. But it also means downloading a 30 GB checkpoint and owning the GPU to run it. This pack inverts that: your GPU stays cold, and the graph becomes a control panel for paid inference. The Modelverse Client is the single input you'll connect to every other node here.

What it does

This node holds exactly one thing: your API key. Drop it in the api_key field, and it emits a client of type MODELVERSE_API_CLIENT that every generation node in the pack accepts.

The clever bit is the empty field. Leave api_key blank and the node falls back to reading MODELVERSE_API_KEY from a config.ini file in the plugin folder - which the plugin creates automatically on first load. That's the setup the README pushes: get a key from the Modelverse console, put it in config.ini, and your workflow JSON never contains the secret. That matters when you share .json files, because a pasted key is a burned key.

[API]
MODELVERSE_API_KEY = your_key_here

Leave both the field and the config file empty and the node raises an error telling you exactly that. Fair enough.

How to install it

This is the shared install for the whole pack - you only do it once:

1. Open ComfyUI → Manager → Custom Nodes Manager.
2. Search "ComfyUl-UCloud", hit Install, then restart ComfyUI.

Or the manual route:

cd ComfyUI/custom_nodes
git clone https://github.com/ucloud/comfyui-plugin
# restart ComfyUI

There are no model downloads and no heavy dependencies - just requests, pillow, numpy, openai, and GitPython, all light. That's the whole appeal of an API pack.

What to actually do

Wire the client output into whichever Modelverse node you want. A typical starting graph is: Modelverse Client → Modelverse Qwen Image → Preview. Then run, watch the console, and remember that every run costs credits on their account - this is a paid API, so resist the urge to queue ten requests on your first test.

The only real gotcha: if you're on a workflow someone shared and it errors with "API_KEY is empty", the fix is either the api_key field or that config.ini file. It's not a bug - the pack is just refusing to send requests with no credentials.