刻意「無聊」的 API
好的影像 API 是無聊的。你給它一張圖，它回傳一個結果，你繼續做你的產品。Remove BG 就按這個標準設計。
curl 'https://api.codia.ai/v1/open/remove_bg' \
-H 'Authorization: Bearer {codia_api_key}' \
-H 'Content-Type: application/json' \
--data '{ "image_url": "https://example.com/product.jpg" }'{
"code": 0,
"message": "ok",
"data": {
"image_url": "https://processed-image-url.com/result.png"
}
}一個端點、一個必填欄位、一個回應結構，就這些。本文剩下的內容講我們為了保住這麼小的介面放棄了什麼，以及 API 在真實影像流水線裡的表現。
何謂「乾淨」的去背
懶人版的背景去除回傳一張帶柔軟 alpha 通道的圖，縮圖看著可以，但放在明亮背景或清晰商品頁上就會崩壞。Remove BG 的目標相反：當客戶在商品頁放大到細節時，去背結果仍然立得住。
具體來說，邊緣品質那一步做了三件重要的事：
- 輪廓處的亞像素 alpha。 Mask 是 matte 的，不是閾值化的——細微的邊緣髮絲、細金銀飾、蕾絲、玻璃杯沿保留柔和邊緣，而不是被裁到最近的整像素。
- 前景顏色去汙染。 邊緣附近像素常帶原背景的綠色或紅色溢色。API 會移除這種色偏，讓主體在任意新背景上合成時不會留光暈。
- 無投影拖尾。 如果原圖在白面上有投影，投影隨背景一同去掉。若你想保留投影（部分電商團隊要），主體自身的自陰影——鞋底的暗面、馬克杯的暗側——會保留。
實操檢驗：把回傳的 PNG 合成到 #111 背景上。如果看到明顯亮邊，這張去背不乾淨。Remove BG 在商品、人、寵物、食物、家具、車輛上都應通過。會有挑戰的是運動模糊主體，以及主體與雜亂背景共享色盤的場景。
延遲預算
公示的處理時間約 600 ms。這是模型推論加輕量 I/O；從你發請求到拿到結果 URL 的端到端延遲在 800–1200 ms，取決於影像尺寸與區域。對批次負載，API 並行能力強——一個 Key 在觸發速率限制前，通常能從單行程並行數百請求，對商品上傳類的互動流足夠。
如果你是同步 UI——使用者拖圖、期望立刻看結果——800 ms 的手感很好。如果你是夜間批次處理 50,000 SKU，起一個 worker 池、暫時失敗重試，並按速率限制大小來設定並行。
API 的五種落地形態
1. 電商商品上傳。 商家上傳商品圖時呼叫 Remove BG，把透明 PNG 與原圖一併儲存，讓範本系統按品牌背景（列表頁白、hero 圖漸層、季節性活動色）合成。你不需要再次跑模型。
2. 設計工具素材管道。 把圖拖進畫布，背景就沒了。這就是 Figma / Canva 的形態，也是我們調校的延遲目標。
3. 相簿類 App。 端側模型越來越強，但體積大、舊機慢、更新貴。如果你的 App 本來就要連網做別的事，API 去背常常是正確選擇——二進位更小、結果更好、迭代更容易。
4. 廣告創意自動化。 商品 feed 驅動的可變背景廣告範本：去背一次，合成 N 次，上線 N 套創意。Remove BG 是「去背一次」的那一步。
5. AI 產生流水線。 產生器在純色背景上產出主體，第二條流水線把它合成到場景裡。這一步的乾淨 alpha，是「可用產出」與「明顯 AI 糊邊」之間的差別。
失效模式與處理
每個影像 API 都有它不喜歡的輸入。值得關注的：
- 極低解析度（長邊 < 400 px）。模型需要足夠的訊號去 matte 邊緣；低於這個閾值，去背顯得量化。面向使用者的產品應在呼叫前拒收。
- 已帶透明度的輸入。 若來源圖已有 alpha，模型會把透明區當作背景。若想保留原有透明度，先在白底上扁平化。
- 極端運動模糊。 賽車、極限運動。模型能保住主體，但邊緣會比更清晰的擷取更柔和。
- 主體與背景撞色。 白底白裙、黑沙發黑狗。結果仍可用，但邊緣信心度下降。這種情況值得加一道人工審查。
回應裡的 code 欄位：0 是成功。非 0（配人類可讀的 message）代表輸入問題——URL 不可達、格式不支援、圖過大、觸發速率限制。處理非 0 的策略是：網路錯重試，輸入錯快速失敗回饋使用者。
計費與維運注意點
公開方案按成功呼叫計量，未用額度按月滾動，以免浪費。大量場景——月處理數千萬張——可走企業方案：固定額度承諾、獨立 Key、自訂速率限制、優先佇列。免費方案沒有尺寸分層：品質一致，差異只在配額和 SLA。
輸出圖透過 CDN URL 提供，有效期足夠你下載快取。不要熱連結；拉下來存到自己儲存桶再對外。URL 只對當次請求有效，不是長效。
快速上手
- 在 codia.ai/dashboard/developer 取得 Key。
- 對任意一張商品圖跑上面那條
curl。 - 下載
data.image_url，在深色背景上合成，放大看邊緣。 - 看起來不錯——通常也是——把它接進流水線作為上傳後的那一步。
完整參考、錯誤碼、量價表在 /api#remove-background。
目標是一個無聊的 API：一個端點、快速乾淨的去背、在負載下可靠。如果你接完就不用再想它，那就贏了。