從 remove.bg 遷移

remove.bg 的 API 即將停止服務。改一行程式碼，其餘不變。

Q: remove.bg 要停止服務了嗎？

remove.bg 的獨立網站和自助 API 將於 2026年12月1日 上午9:00 CET 停止服務。API 將遷移到 Leonardo.Ai（Canva 旗下公司），屆時需要修改你的整合。來源：Leonardo.Ai 的公告 https://www.leonardo.ai/news/removebg-api-leonardo。

remove.bg 的獨立網站和自助 API 將於 2026年12月1日上午9:00 CET 停止服務。API 將遷移到 Leonardo.Ai（Canva 旗下公司），屆時需要修改你的整合（Leonardo.Ai 的公告）。removebackground.dev 接受相同的請求：把程式碼指向我們的 URL，換用我們的金鑰，就完成了。

註冊 · 贈送 50 免費點數遷移清單

remove.bg 的自助 API 將於 2026年12月1日上午9:00 CET 停止服務

唯一需要修改的一行

修改前https://api.remove.bg/v1.0/removebg

修改後https://removebackground.dev/v1.0/removebg

同樣使用 X-Api-Key 請求頭，只是換成你的 removebackground.dev 金鑰。相同的引數名、相同的響應頭、相同的 {"errors": [...]} 錯誤格式。

修改前後對比

四種語言的典型整合示例。金鑰從 REMOVEBG_API_KEY 讀取，因此唯一需要修改的就是高亮的 URL。

修改前：remove.bg

curl -f -H "X-Api-Key: $REMOVEBG_API_KEY" \
  -F 'image_file=@photo.jpg' \
  -F 'size=auto' \
  -o no-bg.png \
  https://api.remove.bg/v1.0/removebg

修改後：removebackground.dev

curl -f -H "X-Api-Key: $REMOVEBG_API_KEY" \
  -F 'image_file=@photo.jpg' \
  -F 'size=auto' \
  -o no-bg.png \
  https://removebackground.dev/v1.0/removebg

在用 Zapier、Make 或 n8n？

開啟呼叫 remove.bg 的 HTTP 請求步驟（Zapier Webhooks、Make HTTP、n8n HTTP Request），將 URL 改為 https://removebackground.dev/v1.0/removebg，並將 X-Api-Key 的值改為你的 removebackground.dev 金鑰。其他欄位保持不變。

引數相容性

你的 remove.bg 請求傳送的所有內容都會被接受。少數選項在這裡不起作用，下表中已註明。

引數	狀態	說明
`image_file / image_file_b64 / image_url`	支援	支援 multipart、urlencoded 或 JSON 請求體。JPG、PNG 或 WebP，最大 25 MB。
`size`	支援	auto、full、4k 和 50MP 返回原始解析度（最高 25 MP）；preview、small 和 regular 約 0.25 MP；medium 1.5 MP；hd 4 MP。始終消耗 1 點數。
`format`	支援	auto（有透明區域時為 PNG，否則為 JPG）、png、jpg、webp 和 zip（color.jpg + alpha.png）。
`crop / crop_margin`	支援	以 px 或主體的 % 表示，1–4 個 CSS 風格的值（"10% 20%" = 垂直、水平）；每邊最多 500px 或 50%。
`roi`	支援	"x1 y1 x2 y2"，單位為 px 或 %：僅保留區域內的主體。
`scale / position`	支援	scale 為 10%–100% 或 original；position 為 center、original 或 "x% y%"。
`channels`	支援	rgba（去背）或 alpha（灰度蒙版）。
`bg_color`	支援	十六進位制顏色，帶或不帶 #（81d4fa），或顏色名稱。8 位十六進位制值會保留顏色並丟棄其 alpha。
`bg_image_url / bg_image_file`	支援	去背會疊加在你的背景圖片上，背景圖片以 cover 方式適配輸出尺寸。
`Accept: application/json`	支援	返回 { data: { result_b64, foreground_top, foreground_left, foreground_width, foreground_height } }。
`type / type_level`	接受但忽略	主體會被自動識別；X-Type 始終為 "other"。
`semitransparency`	接受但忽略	柔和邊緣和半透明區域直接來自模型生成的蒙版。
`shadow_type / shadow_opacity / add_shadow`	接受但忽略	不新增陰影。
`長時間執行的請求`	有差異	我們最多等待 110 秒；如果屆時圖片仍未就緒，你會收到可重試的 503（除非處理完成，否則不扣費）。

響應頭

呼叫成功時返回圖片位元組（image/png、image/jpeg、image/webp 或 application/zip）以及以下響應頭。傳送 Accept: application/json 則改為返回 result_b64。

響應頭	含義
`X-Width / X-Height`	結果的尺寸（畫素）。
`X-Credits-Charged`	該圖片消耗的點數：始終為 1（失敗的圖片為 0）。
`X-Type`	始終為 "other"（主體自動識別）。
`X-Foreground-Top / -Left / -Width / -Height`	結果中主體的邊界框，單位為畫素。
`X-Request-ID`	回傳你的 X-Request-ID，或一個生成的 id。額外提供。
`X-Matte-Confidence / X-Matte-Ambiguous-Ratio`	蒙版的乾淨程度（0–1），以及柔和畫素的佔比。額外提供：可用於標記需要人工檢查的圖片。

錯誤

狀態碼	含義
`400`	引數或圖片無效（錯誤碼如 invalid_size、invalid_crop_margin、missing_source、file_too_large、unknown_foreground）。
`402`	insufficient_credits：請在價格頁面充值。
`403`	auth_failed：X-Api-Key 缺失或無效。
`429`	rate_limit_exceeded。
`500 / 503`	處理失敗、超時或服務暫時不可用。請重試；失敗的圖片免費。

使用 GET https://removebackground.dev/v1.0/account 查詢餘額：響應採用 remove.bg 的帳戶格式。完整說明見 API 參考。

點數：每張圖片 1 點數，永不過期

每張成功的圖片消耗 1 點數，無論尺寸或選項如何。失敗的圖片免費。新帳戶贈送 50 免費點數用於測試。

US$174,000 點數每 100 張圖片 US$0.43

US$4915,000 點數每 100 張圖片 US$0.33

US$9940,000 點數每 100 張圖片 US$0.25

點數永不過期一次充值，下週或明年再用都行。
無需訂閱一次性點數包，不會自動續費。
失敗的圖片免費只有成功去除背景才消耗點數。

檢視價格

遷移清單

獲取 removebackground.dev API 金鑰註冊（贈送 50 免費點數），然後在帳戶頁面建立金鑰。
修改一行程式碼將程式碼指向 https://removebackground.dev/v1.0/removebg，並把新金鑰放在同一個 X-Api-Key 請求頭中。
測試一張圖片傳送一個真實請求，並將輸出與你目前得到的結果進行比較。
切換流量在 2026年12月1日上午9:00 CET 前部署。一次充值點數，永不過期。

remove.bg 遷移常見問題

remove.bg 要停止服務了嗎？

remove.bg 的獨立網站和自助 API 將於 2026年12月1日上午9:00 CET 停止服務。API 將遷移到 Leonardo.Ai（Canva 旗下公司），屆時需要修改你的整合。來源：Leonardo.Ai 的公告 https://www.leonardo.ai/news/removebg-api-leonardo。

最簡單的 remove.bg API 替代方案是什麼？

removebackground.dev 提供相容 remove.bg 的端點。將 https://api.remove.bg/v1.0/removebg 改為 https://removebackground.dev/v1.0/removebg，在同一個 X-Api-Key 請求頭中傳送 removebackground.dev 金鑰，其餘程式碼保持不變：引數名、響應頭和錯誤格式都一致。

我需要在 2026 年 12 月前重寫整合嗎？

不需要。請求使用相同的引數（image_file、image_url、size、format、crop、bg_color…），並獲得同類響應：帶 X-Width、X-Height 和 X-Foreground-* 響應頭的圖片位元組，或包含 result_b64 的 JSON。只有 URL 和金鑰需要更改。

支援 Zapier、Make 或 n8n 嗎？

支援。在你的 HTTP 請求步驟（Zapier Webhooks、Make HTTP、n8n HTTP Request）中，將 URL 改為 https://removebackground.dev/v1.0/removebg，並將 X-Api-Key 的值改為你的 removebackground.dev 金鑰。其他都不用改。

費用是多少？

每張成功的圖片 1 點數，無論尺寸或選項如何。無需訂閱：一次性充值 US$17、US$49 或 US$99，點數永不過期。失敗的圖片免費。新帳戶贈送 50 免費點數。

支援哪些 remove.bg 引數？

image_file、image_file_b64、image_url、size、format（auto、png、jpg、webp、zip）、crop、crop_margin、roi、scale、position、channels、bg_color、bg_image_url 和 bg_image_file。type、type_level、semitransparency 及陰影相關選項會被接受但忽略，因此傳送這些引數的請求依然可以正常工作。

還能像以前一樣查詢餘額嗎？

可以。使用你的金鑰呼叫 GET https://removebackground.dev/v1.0/account，會以 remove.bg 的帳戶格式返回你的點數。

removebackground.dev 與 remove.bg 有關聯嗎？

沒有。remove.bg 是其所有者的商標。removebackground.dev 是一個獨立服務，接受相同的 API 請求。

在 2026年12月1日上午9:00 CET 前完成切換