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
catboxwhen you intend to send a Catbox key throughkey. Selectuguuwhen you want to use the Uguu upload path;keyis not sent to Uguu. - If another node needs a bare URL, account for the
Posted image to ... with url:text before passing alongIMAGE_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
catboxanduguubranches do not reach it during ordinary execution. An unsuccessful HTTP response for either supported host can instead leaveIMAGE_URLempty. - Solution: If the output is empty, confirm that the service is reachable and accepting uploads, then try again. For Catbox, also check the
keyvalue 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
fileslist. 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
uguuselected, the node expects a readable JSON response containing a first file entry with aurlfield. 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
IMAGEto 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
IMAGEand test with a single image before trying a batch.
