canonical: https://jentic.com/apis/poof.bg/poof-api

# Poof Bg Poof API

Poof is a background removal API that uses machine learning to automatically extract subjects from images, leaving transparent backgrounds. The API accepts images in common formats (JPEG, PNG, WebP) and returns processed images with backgrounds removed, suitable for e-commerce product photography, marketing collateral, and profile pictures. Developers integrate it into content workflows, image editing tools, and automated design systems. The single endpoint simplicity makes it straightforward to implement compared to complex image processing libraries. Poof handles edge cases like hair detail preservation, partial transparency, and complex backgrounds without requiring manual selection or masking. It processes images in seconds with consistent quality, enabling high-throughput workflows for marketplaces, design platforms, and user-generated content moderation.

## For AI agents

Remove backgrounds from images automatically using machine learning, returning transparent PNG files suitable for design and e-commerce.

## Scope

Provides automated background removal only. Does not perform general image editing, color correction, or object manipulation-use dedicated image processing APIs. Does not host or deliver images-use CDN services.

## Capabilities

- Remove backgrounds from images automatically with machine learning
- Process JPEG, PNG, and WebP image formats
- Preserve fine details like hair edges and transparency effects
- Handle complex backgrounds including gradients and patterns
- Return processed images as transparent PNG files
- Process images in seconds with consistent quality

## Use cases

### E-commerce Product Photography Processing

Online retailers automate product image preparation by removing backgrounds from supplier photos, user-generated content, and in-house photography. The API processes images uploaded by sellers, standardizing product presentation with clean white or transparent backgrounds. Marketplaces integrate Poof into their listing creation flows, automatically processing images before publication. This reduces manual editing time from minutes per image to seconds, enabling scalable product catalog management. Merchandising teams can re-shoot products on any background knowing post-processing will extract subjects cleanly.

Example prompt: When seller uploads product image, send to Poof API for background removal, receive transparent PNG, overlay on standardized marketplace background color, save processed image to CDN, update product listing with clean image URL.

### Marketing Collateral and Design Automation

Marketing teams use Poof to prepare images for ads, social posts, and website graphics where subjects need to overlay branded backgrounds. Design systems integrate the API to automatically process headshots, product shots, and lifestyle imagery, enabling dynamic creative generation. Automated design tools call Poof to extract subjects, then composite them onto template backgrounds with text and branding. This enables personalized marketing at scale where hundreds of ad variants are generated programmatically with different subject combinations and backgrounds.

Example prompt: Load subject images for ad campaign, send each to Poof for background removal, composite extracted subjects onto branded template backgrounds, add text overlay, generate 50 ad variants, export for social media platforms.

### User Profile Picture Enhancement

Social platforms and professional networking sites use Poof to enhance user-uploaded profile pictures by removing distracting backgrounds. The API processes profile photos, removing cluttered rooms, outdoor scenes, or event backgrounds, leaving the subject on transparent or neutral backgrounds. This creates visual consistency across user directories and improves perceived professionalism. Apps offer this as a premium feature where users upload casual photos and receive professionally presented profile pictures with clean backgrounds automatically.

Example prompt: When user uploads profile picture, detect faces and crop to portrait orientation, send to Poof for background removal, overlay on subtle gradient or solid color, offer both transparent and colored versions, let user select preferred output.

### Batch Image Processing for Catalogs and Archives

Organizations with large image archives use Poof to bulk-process historical product photos, team headshots, or inventory images, standardizing backgrounds across collections. The API integrates into batch processing pipelines that iterate through S3 buckets or media libraries, process each image, and save results. This modernizes legacy catalogs where products were photographed on inconsistent backgrounds. Museums and archives use it to extract artifacts from old photography backgrounds, creating clean imagery for digital collections and search results.

Example prompt: Iterate through product image S3 bucket, fetch each image, send to Poof API, validate processed output, save transparent PNG to processed bucket, update database with new image URL, generate progress report for completed batch.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/remove` | Remove background from an image and return transparent PNG |

## Key resources

- **Background Removal** — Remove backgrounds from images automatically.

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 66 / 100
- **Maturity:** AI-Aware
- **Dimensions:**
  - Foundational Compliance: 100 / 100
  - Developer Experience & Jentic Compatibility: 63 / 100
  - AI-Readiness & Agent Experience: 46 / 100
  - Agent Usability: 94 / 100
  - Security: 50 / 100
  - AI Discoverability: 100 / 100
- **View full report:** https://jentic.com/apis/poof.bg/poof-api/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring Poof by hand means handling its bearer token auth and posting the image payload to the removal endpoint yourself. Through Jentic you install once, import Poof from the API Directory, store the token once, and your agent calls it.
- **Permission scoping:** Poof exposes a single background-removal operation (POST /remove) that takes the image in the request body, so you limit the agent to just the operation it needs. No other operation is added unless you choose to.
- **Credential handling:** Your Poof token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'remove background from image', and Jentic returns the matching Poof operation with its image input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Remove.bg API** — Remove.bg provides AI-powered background removal with extensive format options and credit-based pricing.
- **Cloudinary Upload API** — Cloudinary provides image hosting, transformation, and CDN delivery with built-in editing features.

## FAQ

### What authentication does the Poof API use?

The Poof API uses Bearer token authentication. You obtain an API token from your Poof account and include it in the Authorization header for all requests.

### What image formats does Poof support?

Poof accepts JPEG, PNG, and WebP image formats as input. The API returns processed images as transparent PNG files suitable for design and e-commerce use.

### How does Poof handle complex backgrounds and fine details?

Poof uses machine learning models trained to preserve fine details like hair edges and partial transparency while removing backgrounds. It handles complex scenes including gradients, patterns, and multi-subject images with consistent quality.

### Can I process images in batch with the Poof API?

Yes, you can call the single /remove endpoint in a loop or parallel processing pipeline to batch-process multiple images. Many users integrate Poof into workflow systems that process image collections from S3, CDNs, or databases.

### How do AI agents use the Poof API through Jentic?

Agents search Jentic for tasks like 'remove background from product photo' and receive the Poof operation schema. Jentic securely stores API tokens, handles authentication, and allows agents to process images by URL or file upload with natural language instructions.

### Can I limit what my agent is allowed to do with the Poof API?

Yes. Poof exposes a single background-removal operation, POST /remove, which takes the image in the request body, and because you run Jentic One yourself you decide that this is the only operation your agent may call. No other operation is added unless you choose to grant it, so the agent cannot reach beyond removing backgrounds from the images you send. Your Poof bearer token stays with your own instance and is injected only when that permitted operation runs, never entering the agent's prompt or logs.
