removebg-api

TotalClaw 作者 totalclaw

使用带有 API 密钥身份验证和透明 PNG 输出的remove.bg API 删除图像背景。当需要高质量的剪切并且可以接受云处理时使用。

安装 / 下载方式

TotalClaw CLI推荐

totalclaw install totalclaw:totalclaw~rolandkakonyi-removebg-api

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~rolandkakonyi-removebg-api/file -o rolandkakonyi-removebg-api.md

## 概述（中文）

使用带有 API 密钥身份验证和透明 PNG 输出的remove.bg API 删除图像背景。当需要高质量的剪切并且可以接受云处理时使用。

## 原文

# removebg-api

Use remove.bg for high-quality background removal.

## API key setup

1. Create/sign in at `https://www.remove.bg/dashboard#api-key`
2. Create an API key
3. Configure `REMOVE_BG_API_KEY` in OpenClaw config (`openclaw.json`) so it is present in runtime environment.

## Important

- Skill metadata (`requires.env`) declares that `REMOVE_BG_API_KEY` is required.
- Metadata does **not** auto-load shell env files.
- Preferred: provide key via OpenClaw config-managed environment.

## Usage (preferred: uv)

Run from the skill directory:

```bash
uv run scripts/removebg_api.py --input /path/in.jpg --output /path/out.png
```

Options:

- `--size auto|preview|full|4k` (default: `auto`)
- `--format png|jpg|zip` (default: `png`)
Security defaults:

- `--input` must be a real image file *inside the OpenClaw workspace*.
- Allowed input types: `.png`, `.jpg`, `.jpeg`, `.webp` (extension + magic-byte validation).
- `--output` must be under `outputs/removebg-api/` inside the workspace.
- Large/abusive files are rejected (size + dimension limits).
- This prevents arbitrary file read/write outside normal skill boundaries.

Example:

```bash
uv run scripts/removebg_api.py --input ./input.jpg --output ./output.png --size auto --format png
```

## Fallback (without uv)

```bash
python3 scripts/removebg_api.py --input ./input.jpg --output ./output.png
```

## Output

- Writes result file to `--output`
- Prints `MEDIA:` line for chat workflows

## Notes

- API usage may consume free credits / paid quota.
- No absolute-path requirement for skill docs; use local paths in examples.