file

Upload an image file

Upload an image file to cloud storage.

Image limits:

  • Maximum file size: 50 MB
  • Maximum width/height per edge: 16384 px
  • Maximum total pixel count: 64 megapixels (67108864 pixels)

Uploads that exceed any of these limits are rejected with HTTP 400.

post/api/upload/image

Request

Request body multipart/form-data

imagestring binary required

The image file to upload

overwritestring

Whether to overwrite existing file (true/false). Note: Accepted for ComfyUI API compatibility but effectively ignored in cloud. Cloud uses content-addressed storage (hash-based deduplication), so identical content always maps to the same hash. Re-uploading the same content is a no-op.

subfolderstring

Optional subfolder path. Note: Accepted for ComfyUI API compatibility but ignored for storage. Cloud stores assets by hash only. The subfolder is returned in the response for client-side organization but is not used for server-side storage paths.

typestring

Upload type (defaults to "output"). Note: Accepted for ComfyUI API compatibility. Cloud stores all uploads as assets with tags rather than directory-based organization.

Response

Image uploaded successfully

namestring

Filename of the uploaded image

subfolderstring

Subfolder path where image was saved

typestring

Type of upload (e.g., "output")

Changes

No recorded changes to this operation across all 1 revision of this API.