PoYo Upload Media

Every generation node in this pack can auto-upload media you wire into it - connect an IMAGE to PoYo_GenerateImage and it quietly uploads it before submitting. So why does PoYo_UploadMedia exist? Because sometimes you want the upload to be its own step: get a file onto PoYo's servers, grab the public file_url it returns, and reuse that URL across multiple jobs or put it into an input_json manually. It's the explicit, visible version of a step the friendly nodes do behind your back.

You'll reach for it when you're hand-building requests with PoYo_RunModel or PoYo_SubmitJob and need a media URL to drop into the input JSON, or when you want to upload once and feed the same file to several models without re-uploading each time.

Mechanism. It takes exactly one of three optional inputs, no more, no less - the node hard-errors if you give it zero or more than one:

• image (IMAGE) - the tensor is converted to PNG and uploaded as comfyui-input.png.
• audio (AUDIO) - the waveform is converted to WAV and uploaded as comfyui-input.wav.
• file_path (STRING) - a path to any local file, uploaded as-is with its own filename.

The upload goes to PoYo's POST /api/common/upload/stream endpoint and the response is parsed for the first file URL, which is what you get back. That's the whole node - upload, return URL, done.

Outputs. Two STRINGs: file_url (the public URL to the uploaded file - keep it handy, that's the whole point) and response_json (the raw upload response, in case you need whatever metadata PoYo returned).

Install. Part of the poyo-comfyui pack, which needs ComfyUI 0.32.0+ (native node system). ComfyUI Manager (search "PoYo"), comfy node install poyo-nodes, or:

cd ComfyUI/custom_nodes
git clone https://github.com/PoyoAPI/poyo-comfyui.git

then restart. No models to download, nothing heavy to install.

Where people get burned. The one-vs-many input rule is the classic trip: connect an image and also type a file_path, and you get an error demanding exactly one. Beyond that, remember what "upload" means here - your image or audio is now on PoYo's servers, subject to their retention and moderation, so don't upload anything you wouldn't want leaving your machine. And the key setup applies like everywhere in this pack: POYO_API_KEY in the environment, or python -m poyo_nodes.configure writing to ~/.poyo/comfyui.json.