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

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

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

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

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

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

بداية سريعة

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

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

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)

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. أرسل حقلًا واحدًا فقط من حقول الصورة الثلاثة.

لا ندعم 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 للحصة اليومية. أرسل Accept: application/json لتحصل على JSON:

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

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

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

الأخطاء

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

{"errors": [{"title": "Daily limit of 50 images reached. …", "code": "rate_limit_exceeded"}]}

الحدود

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

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

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

أسئلة

هل هذا بديل رسمي لـ remove.bg؟

لا. لا ترتبط Imagic AI بـ remove.bg أو Canva أو Leonardo.Ai. تقبل الواجهة صيغة طلبات remove.bg حتى تستمر الشيفرة الحالية في العمل.

هل الواجهة مجانية؟

نعم. لكل حساب 50 صورة يوميًا دون تكلفة. كل حجم، بما فيه preview، يُحسب صورة واحدة.

هل تعمل مكتبات remove.bg الرسمية؟

المكتبات التي تسمح بضبط العنوان الأساسي تعمل بتغييره إلى https://imagic-ai.com/api. أما التي تثبّت api.remove.bg في الشيفرة فتحتاج تعديل ذلك السطر أو غلافًا صغيرًا.

هل تحتفظون بصوري؟

تُعالج الصور المرسلة إلى الواجهة وتُعاد في الرد. لا تُضاف إلى أي معرض ولا تُستخدم في التدريب.