Upload Images to Instant Studio

Let's be direct about what this node is: it uploads your generated images to InstantStudio's cloud service. This is the "we're a company and we'd like your outputs" node in the pack - the one that exists to serve InstantStudio's own product, not you. If you don't have an InstantStudio Toolkit account and API key, this node has nothing to do. There's no shame in that being the whole story, but you should know it before you wire it into a workflow expecting something magical.

How it works

It's an output node, so it produces no wire-able outputs - you run it at the end of the graph and it does its thing. For every image in the images input it saves a temp PNG, embeds the ComfyUI workflow metadata into the file (a nice touch: it scrubs your API key out of the prompt metadata first, so you're not shipping credentials around inside PNG chunks), then POSTs them all in one multipart request to the endpoint in url. Auth is two headers: Authorization: Bearer <api_key> and X-User-Email: <email>, plus your note as a query param. On success it prints the returned UUIDs to the console; on failure it raises with the HTTP status and response body. Temp files get cleaned up either way.

Inputs that matter

• images - whatever you want to send
• note - a text note associated with the upload
• email - the email for authentication
• url - defaults to https://toolkit.instantstudio.ai/api/v1/creations
• api_key - defaults to the string "TODO", which is the author's way of saying "you must fill this in"

One mismatch worth flagging: the README says the node needs a "Username," but the actual node asks for an email and an API key. Trust the node, not the README.

Installing it

ComfyUI Manager, search ComfyUI-InstantStudio, install, restart. Or manually:

cd ComfyUI/custom_nodes
git clone https://github.com/InstantStudioAI/ComfyUI-InstantStudio
cd ComfyUI-InstantStudio && pip install -r requirements.txt

Nothing heavy here - it's just requests and Pillow doing the work - and no model downloads. The requirements file lists flash_attn and pyvips, but this node (and the pack) never import them; they're leftovers from the Moondream fork. If the install chokes on flash_attn on Windows, delete that line.

Common issues

The realistic failure mode is authentication: leave api_key as "TODO" and your upload dies with a 401/403 before it leaves your machine. The error message includes the server's response body, which is genuinely helpful. If you don't have an InstantStudio account at all, that's the other failure: you'll just get an auth rejection, and no public sign-up flow is documented in the pack.

The slightly fun twist: because this is just a requests.post under the hood, you can repoint url at your own server and use it as a generic "send my output somewhere" node. Need to push finished images to your own endpoint with a bearer token? It'll do that, and the metadata-scrubbing behavior is a genuinely thoughtful default. But realistically, if you aren't an InstantStudio user, you'll read this, go "ah," and move on to the pack's actually useful node: Moondream.