Recraft Remove Background - ComfyUI Native Node Documentation

A Recraft API node that automatically removes image backgrounds and creates transparent alpha channels

The Recraft Remove Background node uses Recraft’s API to intelligently detect and remove image backgrounds, creating images with transparent backgrounds and corresponding alpha masks.

Parameters

Basic Parameters

Parameter	Type	Default	Description
image	image	-	Input image to remove background from

Output

Output	Type	Description
IMAGE	image	Image with background removed (with alpha channel)
MASK	mask	Mask of the main subject (white areas are preserved)

Source Code

[Node source code (Updated on 2025-05-03)]

class RecraftRemoveBackgroundNode:
    """
    Remove background from image, and return processed image and mask.
    """

    RETURN_TYPES = (IO.IMAGE, IO.MASK)
    DESCRIPTION = cleandoc(__doc__ or "")  # Handle potential None value
    FUNCTION = "api_call"
    API_NODE = True
    CATEGORY = "api node/image/Recraft"

    @classmethod
    def INPUT_TYPES(s):
        return {
            "required": {
                "image": (IO.IMAGE, ),
            },
            "optional": {
            },
            "hidden": {
                "auth_token": "AUTH_TOKEN_COMFY_ORG",
            },
        }

    def api_call(
        self,
        image: torch.Tensor,
        auth_token=None,
        **kwargs,
    ):
        images = []
        total = image.shape[0]
        pbar = ProgressBar(total)
        for i in range(total):
            sub_bytes = handle_recraft_file_request(
                image=image[i],
                path="/proxy/recraft/images/removeBackground",
                auth_token=auth_token,
            )
            images.append(torch.cat([bytesio_to_image_tensor(x) for x in sub_bytes], dim=0))
            pbar.update(1)

        images_tensor = torch.cat(images, dim=0)
        # use alpha channel as masks, in B,H,W format
        masks_tensor = images_tensor[:,:,:,-1:].squeeze(-1)
        return (images_tensor, masks_tensor)