wangbo/ComfyUI
1
0
Fork 0
mirror of https://github.com/comfyanonymous/ComfyUI.git synced 2026-05-30 19:07:25 +08:00
Code Issues Actions 14 Packages Projects Releases Wiki Activity

docs(openapi): deprecate /api/upload/mask in favor of /api/upload/image

Browse Source 
Mark the uploadMask operation as deprecated and point clients at
/api/upload/image. The mask-compositing behavior the endpoint provides
(alpha-compositing the supplied mask onto an original_ref image) is now
expected to happen client-side, with the composited result uploaded
through the unified /api/upload/image path.

The endpoint continues to function for older clients; no runtime
behavior changes ship with this commit. Only the OpenAPI annotation
and the human-facing description are updated.
This commit is contained in:
Matt Miller 2026-05-18 15:47:16 -07:00
parent 292814c31e
commit b0593b8a83
1 changed files with 9 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
openapi.yaml
View File

@ -485,8 +485,15 @@ paths:
post: post:
operationId: uploadMask operationId: uploadMask
tags: [upload] tags: [upload]
summary: Upload a mask image deprecated: true
description: Uploads a mask image associated with a previously-uploaded reference image. summary: Upload a mask image (deprecated)
description: |
Deprecated. Clients should composite the mask onto the source image
client-side and upload the resulting image via POST /api/upload/image
instead. This endpoint will continue to function for older clients,
but will not receive new features.
Uploads a mask image associated with a previously-uploaded reference image.
requestBody: requestBody:
required: true required: true
content: content: