View a file

Retrieve and view a file from the ComfyUI file system. This endpoint is typically used to view generated images or other output files.

GET /api/view

View a file

cURL

curl --request GET \
  --url https://cloud.comfy.org/api/view \
  --header 'X-API-Key: <api-key>'

200

"<string>"

授权

X-API-Key · string · header · 必填

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.

查询参数

filename · string · 必填

Name of the file to view

示例:

"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.

示例:

"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.

示例:

"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

示例:

"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

示例:

"rgb"

响应

200

image/png

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

Processed PNG image with extracted channel