canonical: https://jentic.com/apis/remove.bg

# remove.bg APIs

remove.bg provides image background removal over HTTP. Its APIs let you strip the background from a photo by uploading an image or pointing at an image URL, return the cutout in several output formats and sizes, submit corrected results to improve future output, and read your account credit balance and free-call allowance. Both APIs in this portfolio wrap the same remove.bg service and are authenticated with an API key.

## For AI agents

An agent can remove the background from an image supplied as a file upload or a URL, request different output sizes and formats, submit an improved result, and check the account's remaining credit balance and free API calls across both remove.bg APIs.

## Scope

Use for: Removing image backgrounds, requesting output formats and sizes, submitting improved results, and checking remove.bg credit balance

Not supported:
- video processing
- image generation
- object detection
- photo storage
- content moderation

## APIs

| API | Category | Endpoints | Description |
| --- | --- | --- | --- |
| Background Removal API | media | 3 | Programmatically remove the background of an image, fetch credit balance and free API calls.. |
| remove.bg API | crm | 3 | Programmatically remove image background, get account information. |

## Which API to use

| Need | API | Why |
| --- | --- | --- |
| Remove an image background and check remaining credits | remove-bg-api | The vendor-official spec covers removebg, account, and improve, so prefer it for background removal work |
| Read credit balance and free API-call allowance | main | Exposes the same removebg and account operations if the vendor-official API is unavailable |

## Cross-API use cases

### Remove background then verify credits remain

An agent removes the background from an incoming product photo and then reads the account balance to confirm enough credits remain before processing the next image in a batch.

Example prompt: Call POST /removebg to strip the background, then call GET /account to read the remaining credit balance and free calls

### Batch cutouts with credit-aware throttling

For a queue of images an agent removes each background and periodically checks the free-call allowance and credit balance, pausing when the balance runs low so the pipeline does not fail mid-run.

Example prompt: Poll GET /account for credit balance, then call POST /removebg for each queued image while credits remain

## Why Jentic

- **Setup:** Wiring both remove.bg APIs by hand means sending the API-key header to api.remove.bg and handling the removebg, account, and improve endpoints yourself. Once Jentic One is installed, you or your agent can find and add either API from the Jentic directory to your workspace and call it with one stored key.
- **Permission scoping:** Because both APIs share one key, your own rules in Jentic One decide which operations the agent may call. You can allow background removal and account reads while withholding the improve endpoint unless you add it.
- **Credential handling:** Your single remove.bg API key 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, and covers both APIs.
- **Discovery method:** Agents search the Jentic directory by intent such as removing an image background or checking account credits, and Jentic returns the matching remove.bg operation with its input schema so the agent calls the right endpoint without reading the reference docs.

## Related vendors

- **Cloudinary** — Broader image storage, transformation, and delivery when you need more than background removal
- **imgix** — Real-time image processing and optimization over a URL-based API
- **Unsplash** — Sourcing photos to feed into a background-removal pipeline

## FAQ

### What can I do across the remove.bg APIs?

You can remove the background from an image supplied as a file or a URL, request different output formats and sizes, submit an improved result to refine future output, and read your account credit balance and free API-call allowance. Both APIs wrap the same service, so the capability set is consistent.

### Do the two remove.bg APIs share the same credential?

Yes. Both authenticate with a single remove.bg API key sent in an API-key request header, so one key works across every operation in the portfolio.

### Why are there two remove.bg APIs listed?

The portfolio contains two specs that both wrap the remove.bg background-removal service. The vendor-official spec is the one to prefer for new work; the other covers the same removebg and account operations.

### Can these APIs handle video or generate new images?

No. remove.bg only removes backgrounds from still images and reports account credits. It does not process video, generate images, detect objects, or store your photos.

### How does an agent avoid running out of credits during a batch?

An agent can read the account balance and free-call allowance through the account endpoint, then remove backgrounds while credits remain and pause when the balance runs low. This lets a batch job self-throttle instead of failing partway through.

### How does an agent add remove.bg through Jentic?

Once Jentic One is installed, you or your agent can find and add any API from the Jentic directory to your workspace. The agent searches by intent such as removing an image background, adds the matching remove.bg operation, and calls it with the credential your instance holds.