Save 4 hours! We auto-setup your workflow! Free!

Drop your workflow.json — we handle every dependency, custom node, and model. Just open the link and run.

Auto-Setup Workflow Json (Free) Now!
ComfyUI > Nodes > ComfyUI-ImageUploader > Image Uploader

ComfyUI Node: Image Uploader

Class Name

ImageUploader

Category
image
Author
conquestace (Account age: 5483days)
Extension
ComfyUI-ImageUploader
Latest Updated
2024-05-23
Github Stars
0.01K

How to Install ComfyUI-ImageUploader

Install this extension via the ComfyUI Manager by searching for ComfyUI-ImageUploader
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter ComfyUI-ImageUploader in the search bar
After installation, click the Restart button to restart ComfyUI. Then, manually refresh your browser to clear the cache and access the updated list of nodes.

Visit ComfyUI Online for ready-to-use ComfyUI environment

  • Free trial available
  • 16GB VRAM to 80GB VRAM GPU machines
  • 400+ preloaded models/nodes
  • Freedom to upload custom models/nodes
  • 200+ ready-to-run workflows
  • 100% private workspace with up to 200GB storage
  • Dedicated Support

Run ComfyUI Online

Image Uploader Description

Uploads the first workflow image as a PNG to Catbox or Uguu and returns a message with its hosted URL.

Image Uploader:

ImageUploader uploads an image from your workflow to either Catbox or Uguu so you can obtain a hosted link. It converts the image to PNG before sending it to the selected service. This is useful when you want to share an image generated in your workflow without manually saving and uploading it elsewhere. The node attempts to upload only the first image in a batch, and its result depends on the hosting service accepting the upload.

Image Uploader Input Parameters:

image

The image to upload. This is an IMAGE input; connect an image produced or loaded elsewhere in your workflow. The node converts the first image it receives to an 8-bit PNG before uploading it. If you provide a batch, it does not continue past the first image. No minimum, maximum, or default value is specified.

key

A string sent to Catbox as its userhash value. It lets you supply a Catbox key when you have one; the node does not use this field for Uguu uploads. Its default is an empty string (""). No length limits or other restrictions are specified by the node.

host

The service that receives your image. Choose catbox to send it to Catbox or uguu to send it to Uguu. This choice also determines how the node reads the service’s response: it uses Catbox’s response text or the URL in Uguu’s response data. The available options are exactly catbox and uguu; no default is specified in the node source.

Image Uploader Output Parameters:

IMAGE_URL

A STRING describing the upload result. After a successful response that the node can interpret, it contains Posted image to catbox with url: ... or Posted image to uguu with url: .... Although the socket is named IMAGE_URL, the value is a message containing the URL, not just the URL itself. If the service does not return a response the node recognizes as successful, the string may be empty. There is only one output, corresponding to the first image in the input batch.

Image Uploader Usage Tips:

  • Connect a single image when you need a predictable result. If your input contains multiple images, only the first is attempted.
  • Select catbox when you intend to send a Catbox key through key. Select uguu when you want to use the Uguu upload path; key is not sent to Uguu.
  • If another node needs a bare URL, account for the Posted image to ... with url: text before passing along IMAGE_URL.
  • Check that you are comfortable sending the image to the selected external hosting service before running the node. An upload requires access to that service, and the node saves the transmitted image as PNG.

Image Uploader Common Errors and Solutions:

Error posting image 0: ...

  • Explanation: The source contains this error-printing format, but the selected catbox and uguu branches do not reach it during ordinary execution. An unsuccessful HTTP response for either supported host can instead leave IMAGE_URL empty.
  • Solution: If the output is empty, confirm that the service is reachable and accepting uploads, then try again. For Catbox, also check the key value if you supplied one.

Empty IMAGE_URL

  • Explanation: The node sets its result only when the upload receives HTTP status 200 and, for Uguu, the response contains a nonempty files list. Other responses can produce an empty string without a clear error message.
  • Solution: Verify your internet connection and selected host, then retry. If the issue persists, check the hosting service’s availability or requirements.

requests.exceptions.ConnectionError or requests.exceptions.Timeout

  • Explanation: A network problem can prevent the upload request from reaching the selected service or receiving a response. The node does not catch these exceptions.
  • Solution: Check your connection and whether the selected service is accessible from the machine running your workflow, then retry.

requests.exceptions.JSONDecodeError or KeyError: 'url'

  • Explanation: With uguu selected, the node expects a readable JSON response containing a first file entry with a url field. An unexpected service response can prevent it from extracting the link.
  • Solution: Retry later or switch hosts. If the error continues, inspect the service response in your runtime logs to identify what Uguu returned.

IndexError or image conversion errors

  • Explanation: The node expects the connected IMAGE to contain an image it can convert to PNG. An empty batch or incompatible image data may prevent processing; an empty batch also means the node reaches no return statement.
  • Solution: Connect a valid, nonempty IMAGE and test with a single image before trying a batch.

Image Uploader Related Nodes

Go back to the extension to check out more related nodes.
ComfyUI-ImageUploader
RunComfy
Copyright 2025 RunComfy. All Rights Reserved.

RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Models, enabling artists to harness the latest AI tools to create incredible art.

Image Uploader