واجهة 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 ديسمبر، وما الذي يجب فعله أولًااحصل على مفتاح
- سجّل الدخول بحساب Google.
- افتح حسابي وأنشئ مفتاحًا ضمن «مفاتيح واجهة API لإزالة الخلفية».
- انسخ المفتاح عند ظهوره، فهو يُعرض مرة واحدة فقط.
بداية سريعة
أرسل الصورة كملف مرفوع أو بترميز 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/removebgimport 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. أرسل حقلًا واحدًا فقط من حقول الصورة الثلاثة.
| الحقل | القيم | ملاحظات |
|---|---|---|
| image_file | ملف | JPG أو PNG أو WebP حتى 22 ميغابايت. |
| image_file_b64 | نص base64 | الملف نفسه بترميز base64. تُقبل البادئة data: URL. |
| image_url | رابط http(s) | نحن نُنزّله. عناوين عامة ومنافذ ويب قياسية فقط، وحتى 3 عمليات إعادة توجيه. |
| size | preview · small · regular · medium · hd · full · 4k · auto · 50MP | preview/small/regular: حتى 0.25 ميغابكسل. medium: 1.5. hd: 4. full/4k/auto/50MP: حتى 25 ميغابكسل (PNG حتى 10). كل حجم يُحسب صورة واحدة. |
| format | auto · png · jpg · webp · zip | auto يعيد PNG إذا كانت النتيجة شفافة وJPG إذا لم تكن. ملف zip يضم color.jpg وalpha.png كما في remove.bg. |
| channels | rgba · alpha | alpha يعيد القناع فقط بتدرج الرمادي. |
| bg_color | ست عشري (81d4fa، #81d4fa77) أو اسم لون | يملأ الخلفية المُزالة. صورة JPG دون bg_color تُدمج على خلفية بيضاء. |
| crop | true · false | يقص النتيجة إلى حدود العنصر. |
| crop_margin | مثل 30px أو 10% | مسافة حول العنصر المقصوص، حتى 500px أو 50%. |
| type | auto · person · product · car · animal · graphic · transportation | مقبول للتوافق. يُعاد في X-Type ولا يغيّر القص. |
| model | fast · 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:
{
"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 في الشيفرة فتحتاج تعديل ذلك السطر أو غلافًا صغيرًا.
- هل تحتفظون بصوري؟
- تُعالج الصور المرسلة إلى الواجهة وتُعاد في الرد. لا تُضاف إلى أي معرض ولا تُستخدم في التدريب.
تحتاج بضع صور فقط ودون شيفرة؟
استخدم أداة إزالة الخلفية