@haatlabs-core/provider-background

中文文档
0.18.5发布于 2026/11/14Apache-2.0TypeScriptESM + CJS近 30 天下载 4726

通过 rembg 服务删除背景 .

中文使用文档
文档目录8 节
  1. 安装
  2. 它会做什么
  3. 选项
  4. 错误
  5. 门户和最后期限
  6. 固定设备
  7. 测试
  8. 托管服务

@haatlabs-core/提供商-背景

安装

pnpm add @haatlabs-core/provider-background

它给你的应用程序留下了一个软件包,所以该应用程序持有一个副本: sharp。 。 。 .

它会做什么

由 rembg 服务删除背景,直接或通过服务网关调用. cutoutFromService(baseUrl, image, options) 返回切出( RGBA PNG 大小为 图像; outlineFromService 返回其α通道为 PNG 灰色。 图像必须是 WebP 打电话的人自己做的。 每一个回答都作为陌生人的文件检查: 它的字节,有α,发送大小,最多25兆像素,最多30个米B. sharp 是一个 等同点: 应用程序本身及其设置是使用的。 软件包留下了尖锐的全局 到应用程序;在一个小主机上,呼叫 sharp.cache(false) 财务报告和审定财务报表 sharp.concurrency(1)。 。 。 .

选项

model (单位:千美元)BACKGROUND_MODEL, (中文(简体) ), u2netp(默认), fetch, (中文(简体) ), timeoutMs (10个s), maxReplyBytes (30个米B), maxImageBytes (20 MiB,网关自封:更大的图像为: 在任何请求之前都被拒绝,不是暂时的, gatewayKey, (中文(简体) ), call 财务报告和审定财务报表 signal。 。 。 .

错误

BackgroundRemovalError(message, transient, { retryAfterMs?, cause? })。 。 。 . transient页:1 服务远离、缓慢、忙于工作或失败(a 429或5xx,没有答复,暂停);否则 同样的图像会得到同样的答案。 429或5xx载具 retryAfterMs 从其 重试 - 之后( 秒或日期, 最多5分钟) 。 信息从不引用 服务。 打电话的人的流产被重新提出作为他们的.

门户和最后期限

与 gatewayKey, (中文(简体) ), call (级别、优先权、, deadlineMs进入网关,第4级 没有背景。 时限是 timeoutMs,或 call.deadlineMs 当它是 更早一点localTimeoutMs;一个没有限定数目的最后期限是无的,而门户是 有了这个限度,就永远不要长了。 截止时间是这个电话的: 一个呼叫者的重试再次启动它; 通过 signal 对于一个硬限制。 通过网关 被拒绝身份带有 UpstreamStatusError 作为其事业: isGatewayRefusal(error) 网关401是真的 和403页.

固定设备

@haatlabs-core/provider-background/fixtures数字 : backgroundFixtures.image (一个8 x 6 WebP)和 backgroundFixtures.cutout (RGBA PNG对此进行了回答,通过每张支票). 生产 形状为 rembg 的回答为尖锐,没有记录;每个读取是新副本.

测试

pnpm --filter @haatlabs-core/provider-background test: 单位测试假 fetch。 。 。 .

托管服务

没有自己的Rembg服务, createBackgroundRemover({ mode: 'haatlabs', apiKey }) 将图像( 最多 5 MB) 发送到 RapidAPI 上的 Haatlabs API并读取已签名的切出它 回答方式: PNG 有α通道, 当 API 时可能比图像小 缩放一个大的. createBackgroundRemover({ mode: 'service', baseUrl, gatewayKey }) 实值 cutoutFromService。见 @haatlabs-core/services 财务报告和审定财务报表 https://haatlabs.shop/docs/服务/

版本与发布记录

@haatlabs-core/provider-background 共发布 27 个版本,首次发布于 2026/10/23;过去 12 个月发布了 27 个版本。

版本发布日期距今
0.18.5latest2026/11/144 天前
0.18.42026/11/134 天前
0.18.32026/11/134 天前
0.18.22026/11/134 天前
0.18.12026/11/134 天前
0.18.02026/11/134 天前

关于 @haatlabs-core/provider-background 的常见问题

@haatlabs-core/provider-background 是什么?

通过 rembg 服务删除背景 .

如何安装 @haatlabs-core/provider-background?

在项目目录运行 npm install @haatlabs-core/provider-background,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:sharp(^0.35.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@haatlabs-core/provider-background 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@haatlabs-core/provider-background 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@haatlabs-core/provider-background 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=24。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@haatlabs-core/provider-background 可以商用吗?

@haatlabs-core/provider-background 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@haatlabs-core/provider-background 的下载量有多少?

根据 npm 官方下载统计,@haatlabs-core/provider-background 在 2026/10/17 – 2026/11/15 这 30 天内被下载 4,726 次,日均约 158 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@haatlabs-core/provider-background 还在维护吗?

最新版本 0.18.5 发布于 2026/11/14(4 天前);至今共发布 27 个版本,其中过去 12 个月发布了 27 个;首次发布于 2026/10/23。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。