API من remove.bg يتوقف. غيّر سطرًا واحدًا واحتفظ بكودك.
يتوقف موقع remove.bg المستقل وخدمة API الذاتية في . وتنتقل API إلى Leonardo.Ai (إحدى شركات Canva)، ما يتطلب تغيير تكاملك (إعلان Leonardo.Ai). يقبل removebackground.dev الطلبات نفسها: وجّه كودك إلى رابطنا، واستخدم مفتاحنا، وانتهى الأمر.
تتوقف خدمة API الذاتية من remove.bg في
السطر الوحيد الذي يتغير
https://api.remove.bg/v1.0/removebghttps://removebackground.dev/v1.0/removebgالترويسة X-Api-Key نفسها، مع مفتاح removebackground.dev الخاص بك. أسماء المعاملات نفسها، وترويسات الاستجابة نفسها، وصيغة الأخطاء {"errors": [...]} نفسها.
قبل وبعد
تكامل نموذجي بأربع لغات برمجة. يُقرأ المفتاح من REMOVEBG_API_KEY، لذا فالتعديل الوحيد هو الرابط المميَّز.
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 أو n8n؟
افتح خطوة طلب HTTP التي تستدعي remove.bg (Zapier Webhooks أو Make HTTP أو n8n HTTP Request)، وغيّر الرابط إلى 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. دائمًا رصيد واحد. |
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 | مدعوم | قيمة Hex مع # أو بدونها (81d4fa)، أو اسم لون. القيمة Hex المكونة من 8 خانات تحتفظ باللون وتتجاهل قناة ألفا. |
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 الخاصة بك، أو معرّفًا مُنشأً. إضافي. |
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.
الرصيد: رصيد واحد لكل صورة، ولا تنتهي صلاحيته
كل صورة ناجحة تكلّف رصيدًا واحدًا، مهما كان الحجم أو الخيارات. والصور الفاشلة مجانية. تحصل الحسابات الجديدة على 50 رصيدًا مجانيًا للتجربة.
- الرصيد لا تنتهي صلاحيتهاشحن مرة واحدة، واستخدمه الأسبوع المقبل أو العام المقبل.
- بلا اشتراكباقات لمرة واحدة. لا شيء يتجدد تلقائيًا.
- الصور الفاشلة مجانيةلا يُستهلك الرصيد إلا عند إزالة الخلفية.
قائمة خطوات الانتقال
- احصل على مفتاح API من removebackground.devأنشئ حسابًا (50 رصيدًا مجانيًا) وأنشئ مفتاحًا في صفحة حسابك.
- غيّر سطرًا واحدًاوجّه كودك إلى https://removebackground.dev/v1.0/removebg وضع المفتاح الجديد في الترويسة X-Api-Key نفسها.
- اختبر صورة واحدةنفّذ طلبًا حقيقيًا واحدًا وقارن الناتج بما تحصل عليه اليوم.
- حوّل حركة طلباتكانشر التغيير قبل 1 ديسمبر 2026 في 9:00 ص CET. اشحن رصيدك مرة واحدة؛ فهو لا تنتهي صلاحيته.
الأسئلة الشائعة حول الانتقال من remove.bg
هل يتوقف remove.bg؟
يتوقف موقع remove.bg المستقل وخدمة API الذاتية في 1 ديسمبر 2026 في 9:00 ص CET. وتنتقل API إلى Leonardo.Ai (إحدى شركات Canva)، ما يتطلب تغيير تكاملك. المصدر: إعلان Leonardo.Ai على https://www.leonardo.ai/news/removebg-api-leonardo.
ما أبسط بديل لواجهة API من remove.bg؟
يوفر removebackground.dev نقطة نهاية متوافقة مع remove.bg. غيّر https://api.remove.bg/v1.0/removebg إلى https://removebackground.dev/v1.0/removebg، وأرسل مفتاح removebackground.dev في الترويسة X-Api-Key نفسها، واحتفظ ببقية كودك: أسماء المعاملات وترويسات الاستجابة وصيغة الأخطاء متطابقة.
هل عليّ إعادة كتابة تكاملي قبل ديسمبر 2026؟
لا. تحتفظ الطلبات بالمعاملات نفسها (image_file وimage_url وsize وformat وcrop وbg_color…) وتتلقى النوع نفسه من الاستجابة: بايتات الصورة مع الترويسات X-Width وX-Height وX-Foreground-*، أو JSON يحتوي على result_b64. لا يتغير إلا الرابط والمفتاح.
هل يعمل مع Zapier أو Make أو n8n؟
نعم. في خطوة طلب HTTP (Zapier Webhooks أو Make HTTP أو n8n HTTP Request)، غيّر الرابط إلى https://removebackground.dev/v1.0/removebg وقيمة X-Api-Key إلى مفتاح removebackground.dev الخاص بك. ولا شيء آخر يتغير.
كم التكلفة؟
رصيد واحد لكل صورة ناجحة، مهما كان الحجم أو الخيارات. بلا اشتراك: شحن لمرة واحدة بقيمة 17 US$ أو 49 US$ أو 99 US$، والرصيد لا تنتهي صلاحيته. والصور الفاشلة مجانية. تحصل الحسابات الجديدة على 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 وخيارات shadow فهي مقبولة ويتم تجاهلها، لذا تظل الطلبات التي ترسلها تعمل.
هل يمكنني التحقق من رصيدي كما في السابق؟
نعم. يعيد GET https://removebackground.dev/v1.0/account مع مفتاحك رصيدك بصيغة حساب remove.bg.
هل removebackground.dev مرتبط بـ remove.bg؟
لا. remove.bg علامة تجارية مملوكة لصاحبها. وremovebackground.dev خدمة مستقلة تقبل طلبات API نفسها.
انتقل قبل 1 ديسمبر 2026 في 9:00 ص CET
تتوقف خدمة API الذاتية من remove.bg في
أنشئ مفتاحًا، وغيّر سطرًا واحدًا، واختبر صورة واحدة. يشمل 50 رصيدًا مجانيًا.
remove.bg علامة تجارية مملوكة لصاحبها؛ ولا تربط removebackground.dev بها أي صلة.