Skip to main content
GET
/
api
/
view
View a file
curl --request GET \
  --url https://cloud.comfy.org/api/view \
  --header 'X-API-Key: <api-key>'
"<string>"

Authorizations

​
X-API-Key
string
header
required

API key authentication. Generate an API key from your account settings at https://comfy.org/account. Pass the key in the X-API-Key header.

Query Parameters

​
filename
string
required

Name of the file to view

Example:

"ComfyUI_00004_.png"

​
subfolder
string

Subfolder path where the file is located. Note: Accepted for ComfyUI API compatibility but ignored in cloud. Cloud uses content-addressed storage where assets are stored by hash only. The subfolder is client-side UI metadata and not used for storage lookup.

Example:

"tests/foo/bar"

​
type
string

Type of file (e.g., output, input, temp). Note: In cloud, both output and temp files are stored in the same bucket. The type parameter is used for compatibility but storage location is determined by hash.

Example:

"output"

​
fullpath
string

Full path to the file (used for temp files)

​
format
string

Format of the file

​
frame_rate
integer

Frame rate for video files

​
workflow
string

Workflow identifier

​
timestamp
integer

Timestamp parameter

Example:

"1234567890"

​
channel
string

Image channel to extract from PNG images.

  • 'rgb': Return only RGB channels (alpha set to fully opaque)
  • 'a' or 'alpha': Return alpha channel as grayscale image
  • If not specified, return original image unchanged via redirect
Example:

"rgb"

Response

Success - File content returned (used when channel parameter is present)

Processed PNG image with extracted channel