المطورون

واجهة API لإزالة الخلفية

الطلبات نفسها التي تقبلها واجهة remove.bg، والردود نفسها. غيّر عنوان URL الأساسي والمفتاح، واترك بقية الشيفرة كما هي.

الانتقال من remove.bg

أعلنت remove.bg أن خدمتها المستقلة تُغلق في 1 ديسمبر 2026 وأن طلبات واجهة API ذاتية الخدمة تتوقف في اليوم نفسه، مع انتقال الواجهة إلى Leonardo.Ai. إذا كانت شيفرتك تستدعي api.remove.bg فوجّهها إلى هنا:

قبلhttps://api.remove.bg/v1.0/removebg
بعدhttps://imagic-ai.com/api/v1.0/removebg

يبقى الترويسة X-Api-Key، وتحتفظ الحقول بأسمائها، وتأتي الأخطاء بصيغة remove.bg، لذا تعمل مكتبات العميل التي تسمح بضبط العنوان الأساسي كما هي.

ما الذي يتغير مع الإغلاق في 1 ديسمبر، وما الذي يجب فعله أولًا

احصل على مفتاح

  1. سجّل الدخول بحساب Google.
  2. افتح حسابي وأنشئ مفتاحًا ضمن «مفاتيح واجهة API لإزالة الخلفية».
  3. انسخ المفتاح عند ظهوره، فهو يُعرض مرة واحدة فقط.
إنشاء مفتاح

بداية سريعة

أرسل الصورة كملف مرفوع أو بترميز base64 أو كرابط عام. جسم الرد هو الصورة الجاهزة.

curl
curl -H "X-Api-Key: $IMAGIC_API_KEY" \
  -F "image_file=@photo.jpg" \
  -F "size=auto" \
  -o no-bg.png \
  https://imagic-ai.com/api/v1.0/removebg
Python
import os, requests

response = requests.post(
    "https://imagic-ai.com/api/v1.0/removebg",
    files={"image_file": open("photo.jpg", "rb")},
    data={"size": "auto"},
    headers={"X-Api-Key": os.environ["IMAGIC_API_KEY"]},
)
response.raise_for_status()
with open("no-bg.png", "wb") as out:
    out.write(response.content)
Node.js
import { readFile, writeFile } from "node:fs/promises";

const form = new FormData();
form.append("image_file", new Blob([await readFile("photo.jpg")]), "photo.jpg");
form.append("size", "auto");

const res = await fetch("https://imagic-ai.com/api/v1.0/removebg", {
  method: "POST",
  headers: { "X-Api-Key": process.env.IMAGIC_API_KEY },
  body: form,
});
if (!res.ok) throw new Error(JSON.stringify(await res.json()));
await writeFile("no-bg.png", Buffer.from(await res.arrayBuffer()));

حقول الطلب

تقبل POST /api/v1.0/removebg الصيغ multipart/form-data وapplication/x-www-form-urlencoded وJSON. أرسل حقلًا واحدًا فقط من حقول الصورة الثلاثة.

الحقلالقيمملاحظات
image_fileملفJPG أو PNG أو WebP حتى 22 ميغابايت.
image_file_b64نص base64الملف نفسه بترميز base64. تُقبل البادئة data: URL.
image_urlرابط http(s)نحن نُنزّله. عناوين عامة ومنافذ ويب قياسية فقط، وحتى 3 عمليات إعادة توجيه.
sizepreview · small · regular · medium · hd · full · 4k · auto · 50MPpreview/small/regular: حتى 0.25 ميغابكسل. medium: ‏1.5. hd: ‏4. full/4k/auto/50MP: حتى 25 ميغابكسل (PNG حتى 10). كل حجم يُحسب صورة واحدة.
formatauto · png · jpg · webp · zipauto يعيد PNG إذا كانت النتيجة شفافة وJPG إذا لم تكن. ملف zip يضم color.jpg وalpha.png كما في remove.bg.
channelsrgba · alphaalpha يعيد القناع فقط بتدرج الرمادي.
bg_colorست عشري (81d4fa، ‎#81d4fa77) أو اسم لونيملأ الخلفية المُزالة. صورة JPG دون bg_color تُدمج على خلفية بيضاء.
croptrue · falseيقص النتيجة إلى حدود العنصر.
crop_marginمثل 30px أو 10%مسافة حول العنصر المقصوص، حتى 500px أو 50%.
typeauto · person · product · car · animal · graphic · transportationمقبول للتوافق. يُعاد في X-Type ولا يغيّر القص.
modelfast · preciseخيار خاص بنا (لا يوجد في remove.bg). fast، وهو الافتراضي: نموذجنا القياسي. precise: حواف أدق للشعر والأجزاء الرفيعة والزجاج، وأبطأ قليلًا. كلاهما يُحتسب صورة واحدة، وتوضح الترويسة X-Imagic-Model النموذج المستخدم.

لا ندعم scale وposition وroi وbg_image_url وbg_image_file وخيارات الظل. الطلبات التي تستخدمها تتلقى 400 بدلًا من صورة مختلفة دون تنبيه.

الرد

افتراضيًا يكون جسم الرد هو الصورة نفسها مع هذه الترويسات: X-Width وX-Height وX-Type وX-Foreground-Top وX-Foreground-Left وX-Foreground-Width وX-Foreground-Height وX-Credits-Charged (دائمًا 1) وX-RateLimit-Limit / -Remaining / -Reset للحصة اليومية. والصورة المدفوعة برصيد تحمل أيضًا X-Imagic-Paid: 1 وX-Imagic-Credit-Balance. أرسل Accept: application/json لتحصل على JSON:

Accept: application/json
{
  "data": {
    "result_b64": "iVBORw0KGgo…",
    "foreground_top": 115,
    "foreground_left": 477,
    "foreground_width": 637,
    "foreground_height": 824
  }
}

الحصة المتبقية

تعيد GET /api/v1.0/account بنية حساب remove.bg. القيمة api.free_calls هي عدد الصور المجانية المتبقية اليوم، وcredits.payg هو رصيد الحساب، وcredits.total هو مجموعهما.

الأخطاء

تأتي الأخطاء بصيغة remove.bg الموضحة أدناه. الطلب الفاشل لا يستهلك صورة.

{"errors": [{"title": "Daily limit of 50 free images reached. …", "code": "rate_limit_exceeded"}]}
الحالةالمعنى
400مدخلات خاطئة: لا صورة، أو صورتان، أو ملف غير مقروء، أو خيار غير مدعوم، أو image_url لا يُسمح لنا بتنزيله أو تعذّر تنزيله.
403ترويسة X-Api-Key مفقودة أو خاطئة أو المفتاح مُلغى.
422النموذج المطلوب غير متاح حاليًا (الرمز model_unavailable). أعد المحاولة باستخدام model=fast؛ لن تُحتسب الصورة.
429نفدت الصور الخمسون المجانية لليوم ولم يبق رصيد في الحساب، أو بلغ الحساب 1000 صورة مدفوعة اليوم. تعطي Retry-After عدد الثواني حتى تتجدد الصور المجانية.
503المعالجة غير متاحة مؤقتًا. أعد المحاولة بعد قليل.

الحدود

  • 50 صورة يوميًا لكل حساب تتشاركها جميع مفاتيحه. حتى 3 مفاتيح نشطة لكل حساب لتتمكن من تبديلها.
  • رفع حتى 22 ميغابايت. الناتج حتى 25 ميغابكسل، و10 ميغابكسل لصيغة PNG.
  • توضع الطلبات في طابور وتُعالج بضعة طلبات في كل مرة. توقّع بضع ثوانٍ لكل صورة، وأكثر للصور الكبيرة.
  • بعد الصور الخمسين المجانية، تستهلك كل صورة رصيدًا واحدًا من رصيد الحساب، حتى 1000 صورة مدفوعة يوميًا. يُشترى الرصيد من صفحة الحساب (100 مقابل 5 دولارات أمريكية أو 500 مقابل 19 دولارًا أمريكيًا) ولا تنتهي صلاحيته.

ما الذي تتوقعه من القص

يأتي القص من نموذج isnet-general-use، وهو النموذج نفسه في أداة إزالة الخلفية. يعمل بثبات مع المنتجات والأشخاص والحيوانات أمام خلفيات عادية. نقاط ضعفه الشعر الرفيع والزجاج والعناصر التي تشبه الخلفية في لونها، وقد يتفوق نموذج remove.bg في هذه الحالات. جرّب بعض صورك قبل نقل مسار عمل إنتاجي.

أسئلة

هل هذا بديل رسمي لـ remove.bg؟
لا. لا ترتبط Imagic AI بـ remove.bg أو Canva أو Leonardo.Ai. تقبل الواجهة صيغة طلبات remove.bg حتى تستمر الشيفرة الحالية في العمل.
هل الواجهة مجانية؟
نعم. لكل حساب 50 صورة يوميًا دون تكلفة. كل حجم، بما فيه preview، يُحسب صورة واحدة. بعد ذلك تستهلك كل صورة رصيدًا واحدًا (100 رصيد مقابل 5 دولارات أمريكية).
هل تعمل مكتبات remove.bg الرسمية؟
المكتبات التي تسمح بضبط العنوان الأساسي تعمل بتغييره إلى https://imagic-ai.com/api. أما التي تثبّت api.remove.bg في الشيفرة فتحتاج تعديل ذلك السطر أو غلافًا صغيرًا.
هل تحتفظون بصوري؟
تُعالج الصور المرسلة إلى الواجهة وتُعاد في الرد. لا تُضاف إلى أي معرض ولا تُستخدم في التدريب.

تحتاج بضع صور فقط ودون شيفرة؟

استخدم أداة إزالة الخلفية