Description

@poof-bg/n8n-nodes-poof

This is an n8n community node for the Poof background removal API.

Migrating from remove.bg? It shuts down on 1 December 2026 — see the remove.bg alternative and migration guide.

Poof is the developer-first standard for background removal — precise, fast, and scalable.

n8n is a fair-code licensed workflow automation platform.

Installation

Follow the installation guide in the n8n community nodes documentation.

npm

npm install @poof-bg/n8n-nodes-poof

n8n Desktop/Cloud

1. Go to Settings > Community Nodes
2. Select Install
3. Enter @poof-bg/n8n-nodes-poof and click Install

Operations

Remove Background

Remove the background from an image (PNG, JPG, WebP or a still GIF). An animated GIF is processed as a video: use Remove Video Background for it (this operation fails with a message saying so).

Parameters:

| Parameter | Description |
|———–|————-|
| Input Binary Field | Name of the binary property containing the image |
| Output Binary Field | Name of the binary property for the result |

Options:

| Option | Description | Default |
|——–|————-|———|
| Format | Output format: PNG, JPG, or WebP | PNG |
| Channels | RGBA (transparent), RGB (opaque) or Alpha (grayscale mask only) | RGBA |
| Background Color | Hex, rgb, or name. Setting it fills the background, so the result is opaque; with RGB or JPG and no color the background is white. Ignored with Alpha | none (white for RGB/JPG) |
| Size | Output size preset: full, hd, medium, preview | full |
| Crop to Subject | Crop image to subject bounds (only sent when on) | false |

Remove Video Background

Remove the background from a video (MP4, MOV, WebM, M4V, MKV or animated GIF, up to 5 minutes). The node submits the video, polls the job every 3 seconds until it is done (retrying brief 5xx or network errors with backoff), and downloads the result.

Billing: 5 credits per second of video, rounded up (10 per second above 30 fps). Animated GIF input is always 5 credits per second, whatever its frame rate. Credits are charged when the job is accepted and refunded if it fails; if your remaining credits don’t cover the whole clip, Poof rejects it with 402 Payment Required. Audio is kept except for GIF output and Alpha (mask) output.

Parameters:

| Parameter | Description |
|———–|————-|
| Input | Binary File (upload, max 100 MB) or URL (public video URL, max 500 MB) |
| Input Binary Field | Name of the binary property containing the video (Binary File input) |
| Video URL | Public URL of the video (URL input) |
| Download Result | Download the finished video into a binary property. Off: return the job only; its result_url is a direct link valid for 24 hours |
| Output Binary Field | Name of the binary property for the result |

Options:

| Option | Description | Default |
|——–|————-|———|
| Format | WebM (VP9, transparent), MOV (ProRes 4444, transparent), MP4 (H.264, no transparency) or GIF (looping, 1-bit transparency, no audio, capped at 1280 px on the longest side (720p for widescreen) and 50 fps) | WebM |
| Channels | RGBA (transparent), RGB (on a background color) or Alpha (mask only) | RGBA |
| Background Color | Color behind the subject, e.g. #00ff00 for green screen. Setting it fills the background, so the video is opaque in every format (WebM, MOV and GIF included); with RGB or MP4 and no color the background is white. Ignored with Alpha | none (white for RGB/MP4) |
| Size | Longest-side cap: preview 640 px, medium 1280 px, hd 1920 px; full keeps the source resolution up to 4096 px (4K) | full |
| Timeout (Minutes) | How long to wait for the job before failing. Long 4K clips can take a while; raise it if needed. The job keeps running on Poof after a timeout and can be fetched with GET /v1/jobs/{id} | 30 |

The output JSON is the job: id, status, credits, durationseconds, fps, resulturl, expires_at, stats and more.

Get Account

Retrieve account information including plan details and credit usage.

Returns:

• organizationId – Your organization ID
• plan – Current plan name
• maxCredits – Total credits in billing cycle
• usedCredits – Credits used this cycle
• autoRechargeThreshold – Auto-recharge threshold (if enabled)

Credentials

You need a Poof API key to use this node.

1. Sign up at dash.poof.bg
2. Create an API key in your dashboard
3. In n8n, create new credentials of type Poof API
4. Paste your API key

Example Workflow

[Read Binary File] → [Poof: Remove Background] → [Write Binary File]

1. Read Binary File: Load an image
2. Poof: Remove the background
3. Write Binary File: Save the result

The same works for video: [Read Binary File (clip.mp4)] → [Poof: Remove Video Background] → [Write Binary File (clip.webm)].

Resources

• Poof Documentation
• Poof Dashboard
• n8n Community Nodes

License

MIT