remove.bg'nin API'si kapanıyor. Tek satırı değiştirin, kodunuzu koruyun.
remove.bg'nin bağımsız web sitesi ve self-servis API'si tarihinde sona eriyor. API, Leonardo.Ai'ye (bir Canva şirketi) taşınıyor ve bu da entegrasyonunuzu değiştirmenizi gerektiriyor (Leonardo.Ai'nin duyurusu). removebackground.dev aynı istekleri kabul eder: kodunuzu bizim URL'mize yönlendirin, bizim anahtarımızı kullanın, hepsi bu.
remove.bg'nin self-servis API'si tarihinde sona eriyor
Değişen tek satır
https://api.remove.bg/v1.0/removebghttps://removebackground.dev/v1.0/removebgAynı X-Api-Key başlığı, removebackground.dev anahtarınızla. Aynı parametre adları, aynı yanıt başlıkları, aynı {"errors": [...]} hata biçimi.
Önce ve sonra
Dört dilde tipik bir entegrasyon. Anahtar REMOVEBG_API_KEY değişkeninden gelir, yani tek değişiklik vurgulanan URL'dir.
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
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 veya n8n mi kullanıyorsunuz?
remove.bg'yi çağıran HTTP isteği adımını açın (Zapier Webhooks, Make HTTP, n8n HTTP Request), URL'yi https://removebackground.dev/v1.0/removebg olarak, X-Api-Key değerini de removebackground.dev anahtarınız olarak değiştirin. Diğer tüm alanları olduğu gibi bırakın.
Parametre uyumluluğu
remove.bg isteğinizin gönderdiği her şey kabul edilir. Birkaç seçeneğin burada etkisi yoktur ve aşağıda bu belirtilmiştir.
| Parametre | Durum | Notlar |
|---|---|---|
image_file / image_file_b64 / image_url | Destekleniyor | Multipart, urlencoded veya JSON gövdeleri. 25 MB'a kadar JPG, PNG veya WebP. |
size | Destekleniyor | auto, full, 4k ve 50MP orijinal çözünürlüğü verir (25 MP'ye kadar); preview, small ve regular ≈ 0,25 MP; medium 1,5 MP; hd 4 MP. Her zaman 1 kredi. |
format | Destekleniyor | auto (şeffafsa PNG, değilse JPG), png, jpg, webp ve zip (color.jpg + alpha.png). |
crop / crop_margin | Destekleniyor | Nesnenin px veya % cinsinden payı, CSS tarzı 1–4 değer ("10% 20%" = dikey, yatay); her kenar için en fazla 500px veya %50. |
roi | Destekleniyor | px veya % cinsinden "x1 y1 x2 y2": yalnızca bölgenin içindeki nesne korunur. |
scale / position | Destekleniyor | scale %10–%100 veya original; position center, original veya "x% y%". |
channels | Destekleniyor | rgba (dekupe) veya alpha (gri tonlamalı maske). |
bg_color | Destekleniyor | # ile veya # olmadan hex (81d4fa) ya da bir renk adı. 8 haneli hex rengi korur, alfa değerini atar. |
bg_image_url / bg_image_file | Destekleniyor | Dekupe görsel, çıktı boyutuna cover ile sığdırılmış arka plan görselinizin üzerine yerleştirilir. |
Accept: application/json | Destekleniyor | { data: { result_b64, foreground_top, foreground_left, foreground_width, foreground_height } } döndürür. |
type / type_level | Kabul edilir, yok sayılır | Nesne otomatik olarak algılanır; X-Type her zaman "other" olur. |
semitransparency | Kabul edilir, yok sayılır | Yumuşak kenarlar ve yarı saydam alanlar, modelin maskesinden olduğu gibi gelir. |
shadow_type / shadow_opacity / add_shadow | Kabul edilir, yok sayılır | Gölge eklenmez. |
Uzun süren istekler | Fark | 110 saniyeye kadar bekleriz; görsel o zamana kadar hazır olmazsa yeniden denenebilir bir 503 alırsınız (tamamlanmadıysa ücret alınmaz). |
Yanıt başlıkları
Başarılı bir çağrı görsel baytlarıyla (image/png, image/jpeg, image/webp veya application/zip) ve bu başlıklarla yanıt verir. Bunun yerine result_b64 almak için Accept: application/json gönderin.
| Başlık | Anlamı |
|---|---|
X-Width / X-Height | Sonucun piksel cinsinden boyutu. |
X-Credits-Charged | Bu görselin kullandığı kredi: her zaman 1 (başarısız görseller 0). |
X-Type | Her zaman "other" (nesne algılama otomatiktir). |
X-Foreground-Top / -Left / -Width / -Height | Sonuçtaki nesnenin piksel cinsinden sınırlayıcı kutusu. |
X-Request-ID | X-Request-ID değerinizi veya oluşturulan bir kimliği geri döndürür. Ek. |
X-Matte-Confidence / X-Matte-Ambiguous-Ratio | Maskenin ne kadar temiz olduğu (0–1) ve yumuşak piksellerin oranı. Ek: görselleri incelemeye işaretlemek için kullanışlıdır. |
Hatalar
| Durum | Anlamı |
|---|---|
400 | Geçersiz parametre veya görsel (invalid_size, invalid_crop_margin, missing_source, file_too_large, unknown_foreground gibi kodlar). |
402 | insufficient_credits: fiyatlar sayfasından kredi yükleyin. |
403 | auth_failed: X-Api-Key eksik veya geçersiz. |
429 | rate_limit_exceeded. |
500 / 503 | İşlem başarısız oldu, zaman aşımına uğradı veya hizmet kısa süreliğine kullanılamıyor. Tekrar deneyin; başarısız görseller ücretsizdir. |
Bakiyenizi GET https://removebackground.dev/v1.0/account ile kontrol edin: yanıt, remove.bg'nin hesap yapısındadır. Tüm ayrıntılar API başvurusunda.
Krediler: görsel başına 1 ve süreleri hiç dolmaz
Her başarılı görsel, boyut veya seçenek ne olursa olsun 1 kredidir. Başarısız görseller ücretsizdir. Yeni hesaplara test için 50 ücretsiz kredi verilir.
- Kredilerin süresi dolmazBir kez yükleyin, gelecek hafta da kullanın, seneye de.
- Abonelik yokTek seferlik paketler. Hiçbir şey yenilenmez.
- Başarısız görseller ücretsizKredi yalnızca arka plan kaldırıldığında kullanılır.
Geçiş kontrol listesi
- Bir removebackground.dev API anahtarı alınKaydolun (50 ücretsiz kredi) ve hesap sayfanızda bir anahtar oluşturun.
- Tek satırı değiştirinKodunuzu https://removebackground.dev/v1.0/removebg adresine yönlendirin ve yeni anahtarı aynı X-Api-Key başlığına koyun.
- Bir görselle test edinGerçek bir istek çalıştırın ve çıktıyı bugün aldığınız sonuçla karşılaştırın.
- Trafiğinizi taşıyın1 Aralık 2026 09:00 CET tarihinden önce yayına alın. Bir kez kredi yükleyin; süreleri hiç dolmaz.
remove.bg geçişi hakkında sorular
remove.bg kapanıyor mu?
remove.bg'nin bağımsız web sitesi ve self-servis API'si 1 Aralık 2026 09:00 CET tarihinde sona eriyor. API, Leonardo.Ai'ye (bir Canva şirketi) taşınıyor ve bu da entegrasyonunuzu değiştirmenizi gerektiriyor. Kaynak: Leonardo.Ai'nin https://www.leonardo.ai/news/removebg-api-leonardo adresindeki duyurusu.
remove.bg API'sinin yerine geçecek en basit çözüm nedir?
removebackground.dev'in remove.bg uyumlu bir uç noktası var. https://api.remove.bg/v1.0/removebg adresini https://removebackground.dev/v1.0/removebg olarak değiştirin, aynı X-Api-Key başlığında bir removebackground.dev anahtarı gönderin ve kodunuzun geri kalanını koruyun: parametre adları, yanıt başlıkları ve hata biçimi aynıdır.
Aralık 2026'dan önce entegrasyonumu yeniden yazmam gerekiyor mu?
Hayır. İstekler aynı parametreleri (image_file, image_url, size, format, crop, bg_color…) korur ve aynı türde yanıt alır: X-Width, X-Height ve X-Foreground-* başlıklarıyla görsel baytları ya da result_b64 içeren JSON. Yalnızca URL ve anahtar değişir.
Zapier, Make veya n8n ile çalışır mı?
Evet. HTTP isteği adımınızda (Zapier Webhooks, Make HTTP, n8n HTTP Request) URL'yi https://removebackground.dev/v1.0/removebg olarak, X-Api-Key değerini de removebackground.dev anahtarınız olarak değiştirin. Başka hiçbir şey değişmez.
Ne kadar tutar?
Boyut veya seçenek ne olursa olsun başarılı görsel başına 1 kredi. Abonelik yok: $17, $49 veya $99 tutarında tek seferlik yüklemeler; kredilerin süresi hiç dolmaz. Başarısız görseller ücretsizdir. Yeni hesaplara 50 ücretsiz kredi verilir.
Hangi remove.bg parametreleri destekleniyor?
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 ve bg_image_file. type, type_level, semitransparency ve gölge seçenekleri kabul edilir ve yok sayılır; böylece bunları gönderen istekler de çalışmaya devam eder.
Bakiyemi eskisi gibi kontrol edebilir miyim?
Evet. Anahtarınızla GET https://removebackground.dev/v1.0/account isteği, kredilerinizi remove.bg'nin hesap biçiminde döndürür.
removebackground.dev'in remove.bg ile bir bağlantısı var mı?
Hayır. remove.bg, sahibinin ticari markasıdır. removebackground.dev, aynı API isteklerini kabul eden bağımsız bir hizmettir.
1 Aralık 2026 09:00 CET tarihinden önce geçin
remove.bg'nin self-servis API'si tarihinde sona eriyor
Bir anahtar oluşturun, tek satırı değiştirin, bir görselle test edin. 50 ücretsiz kredi dahil.
remove.bg, sahibinin ticari markasıdır; removebackground.dev'in onunla bir bağlantısı yoktur.