1 رصيد لكل استدعاء
واجهة إزالة الخلفية
أزل خلفيات الصور برمجيًا بطلب POST واحد. مفتاح API واحد، ومخرجات PNG شفافة، وخدمة عديمة الحالة لا تحفظ الصور التي ترسلها أبدًا.
- REST · JSON
- بلا علامة مائية
- لا نخزّن شيئًا
POST /v1/remove-background
ما هي واجهة إزالة الخلفية؟
واجهة إزالة الخلفية من ImgGen AI نقطة نهاية REST تفصل الموضوع في المقدمة عن خلفية الصورة وتعيد ملف PNG شفافًا. ترفع صورة عبر HTTPS، فيكتشف الذكاء الاصطناعي الموضوع تلقائيًا، ويعود القصّ مُرمَّزًا بـ base64 داخل استجابة JSON. لا حاجة إلى قناع ولا إلى تحديد يدوي.
هذه إحدى نقاط النهاية السبع في واجهة تحرير الصور من ImgGen AI، وجميعها تشترك في مفتاح API واحد، وعنوان URL أساسي واحد، وصيغة الطلب والاستجابة نفسها. وإذا احتجت هذه الإمكانية داخل المتصفح لا من الكود، فالنموذج نفسه هو ما يشغّل أداة Background Remover.
معاملات الطلب
أرسل طلب POST إلى https://app.imggen.ai/v1/remove-background، مصادَقًا بمفتاح API في ترويسة Authorization.
| المعامل | النوع | مطلوب | الافتراضي | الوصف |
|---|---|---|---|---|
| image | file | مطلوب | — | The input image to process. Accepts JPEG (JPG), PNG and WebP, up to 25 MB. |
كيف أدمج واجهة إزالة الخلفية؟
أنشئ مفتاح API في حسابك على ImgGen، واضبطه كمتغير بيئة، ثم استدعِ نقطة النهاية. هذا هو الطلب نفسه بـ cURL وNode.js وPython.
curl --request POST \
--url 'https://app.imggen.ai/v1/remove-background' \
--header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
--form image=@/path/to/photo.jpgimport fs from 'node:fs';
const form = new FormData();
form.append('image', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');
const res = await fetch('https://app.imggen.ai/v1/remove-background', {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.IMGGEN_API_KEY}` },
body: form,
});
const data = await res.json();
// data.image is a base64-encoded PNG
fs.writeFileSync('result.png', Buffer.from(data.image, 'base64'));import base64, os, requests
with open("photo.jpg", "rb") as f:
res = requests.post(
"https://app.imggen.ai/v1/remove-background",
headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
files={"image": f},
)
data = res.json()
with open("result.png", "wb") as out:
out.write(base64.b64decode(data["image"]))الاستجابة
يعيد الاستدعاء الناجح استجابة JSON. والنتيجة مُرمَّزة بـ base64 — فُكّ ترميزها قبل كتابتها على القرص أو في تخزين الكائنات. كما تحمل كل استجابة ناجحة ترويسة X-Credit-Remaining برصيدك بعد الاستدعاء.
{
"success": true,
"message": "Background removed successfully",
"image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}حدود وسلوكيات يُستحسن معرفتها
تقبل نقطة النهاية صيغ JPEG (JPG) وPNG وWebP بحجم ملف أقصاه 25 ميغابايت، وتستجيب تزامنيًا خلال 60 ثانية — لا مهمة تستعلم عنها ولا webhook تضبطه.
مخرجات PNG شفافة
تُعاد النتيجة بقناة ألفا حقيقية، فيمكنك تركيبها على أي خلفية أو لون أو قالب دون طلب ثانٍ.
لا حاجة إلى قناع
كشف الموضوع تلقائي — تُفصل المقدمة عن الخلفية نيابةً عنك. لا شيء ترسمه أو تتبعه أو تمرّره كمعامل ثانٍ: أرسل صورة المدخل واقرأ النتيجة.
لا نخزّن شيئًا
يُحفظ المدخل في كائن مؤقت طوال مدة الاستدعاء ثم يُحذف بعده. وهو أمر مفيد حين تعالج صور عملاء لا يُسمح لك بالاحتفاظ بها.
فيمَ تُستخدم واجهة إزالة الخلفية؟
حيث تضع الفرق نقطة النهاية هذه في الإنتاج لمعالجة الصور برمجيًا وعلى نطاق واسع.
كتالوجات التجارة الإلكترونية
أزل خلفيات صور منتجات المورّدين لحظة الرفع، لتظهر في كل صفحة منتج قصّة نظيفة ومتسقة دون أي خطوة تحرير يدوية.
المتاجر والإعلانات المبوّبة
وحّد الصور التي يرفعها البائعون تلقائيًا. مرّر كل عملية رفع عبر نقطة النهاية واحفظ ملف PNG الشفاف إلى جانب الأصل.
الطباعة عند الطلب
اعزل التصاميم والمواضيع قبل تركيبها على النماذج، لتُعرض المعاينات بشكل صحيح مهما كان مقاس المنتج.
منصات التصميم والتحرير
امنح مستخدميك إزالة الخلفية بنقرة واحدة داخل منتجك، دون تدريب نموذج أو استضافته أو تشغيل استدلال خاص بك على AWS أو غيرها.
كم تكلفة واجهة إزالة الخلفية؟
يكلّف كل استدعاء ناجح 1 رصيد، وبذلك تتبع تكلفتك الفعلية لكل صورة الخطة التي تشترك بها. تأتي الأرصدة من خطتك وهي مشتركة بين كل نقاط النهاية ومحرّر الويب، فلا تشتري حصة منفصلة لكل أداة. ويُرد الاستدعاء الفاشل تلقائيًا. اطّلع على كل التفاصيل في صفحة الأسعار.
| الخطة | السعر | الأرصدة | API |
|---|---|---|---|
| Free | $0 | 50 رصيدًا مجانيًا لمرة واحدة | بلا وصول إلى الواجهة |
| Starter | $9.99 / month | 400 رصيد / شهر | الوصول إلى الواجهة مشمول |
| Pro | $29.99 / month | 1,400 رصيد / شهر | وصول إلى الواجهة + دعم ذو أولوية |
| Enterprise | Custom | حجم مخصص | بنية تحتية مخصصة |
آخر تحقق من تكاليف الأرصدة والحدود 2026-08-27.
نقاط نهاية وأدوات ذات صلة
الفرق التي تستخدم واجهة إزالة الخلفية عادةً ما تلجأ إلى هذه بعدها.
متاح أيضًا: تكبير الصور, ترميم الصور, تلوين الصور, توليد الصور.
أسئلة شائعة عن واجهة إزالة الخلفية
- هي نقطة نهاية HTTP تستقبل صورة وتعيد الصورة نفسها بعد إزالة الخلفية وإبقاء الموضوع على طبقة شفافة. ولأنها واجهة برمجية لا محرّرًا، يمكنك استدعاؤها من مهمة في الخلفية أو عامل طابور أو معالج رفع المستخدمين، ومعالجة آلاف الصور دون أن يفتح أحد متصفحًا.
- أنشئ مفتاح API في حسابك على ImgGen، ثم أرسل عبر POST نموذج multipart يحوي حقل image إلى https://app.imggen.ai/v1/remove-background مع ترويسة Authorization: Bearer. الاستجابة بصيغة JSON؛ فُكّ ترميز حقل image بـ base64 واكتبه على القرص أو في تخزين الكائنات. وتجد في هذه الصفحة أمثلة عملية بـ cURL وNode.js وPython.
- رصيد واحد لكل استدعاء ناجح — وهي أرخص نقطة نهاية في الواجهة. تشمل خطة Starter 400 رصيد شهريًا مقابل 9.99 دولار، أي نحو 400 عملية إزالة خلفية، وPro 1,400 مقابل 29.99 دولار. وتُرحَّل الأرصدة غير المستخدمة ما دام الاشتراك فعّالًا، وتُرد الاستدعاءات الفاشلة تلقائيًا، فلا يُحتسب عليك إلا ما عاد من صور.
- يمكنك إنشاء حساب وتجربة أدوات الذكاء الاصطناعي بـ 50 رصيدًا مجانيًا دون بطاقة ائتمان. أما الوصول إلى الواجهة فهو جزء من خطتَي Starter وPro المدفوعتين؛ ولا توجد فئة مجانية دائمة للواجهة، ونفضّل قول ذلك بدل الإعلان عن واحدة تُقيّدك لاحقًا بصمت.
- تقبل الواجهة ملفات JPEG (JPG) وPNG وWebP بحجم أقصاه 25 ميغابايت للصورة الواحدة. وتُعاد النتائج كصورة مُرمَّزة بـ base64 داخل استجابة JSON.
- لا. هذه الواجهة عديمة الحالة: فهي لا تنشئ مشروعًا، ولا تحفظ ملفًا، ولا تحتفظ بصورتك. يُكتب ما ترفعه في كائن مؤقت، ثم يُعالج، ثم يُحذف فور إرجاع الاستجابة. الشيء الوحيد الذي يبقى هو سجل استخدام يوثّق أن استدعاءً قد حدث وكم رصيدًا كلّف. لا تُستخدم صورك أبدًا في تدريب النماذج.
- نعم. كل الخطط، بما فيها المجانية، تشمل حقوق استخدام تجاري كاملة، ولا تحمل أي مخرجات علامة مائية. يمكنك بيع أي شيء تُعيده الواجهة أو طباعته أو نشره.
- تعيد نقطة النهاية ملف PNG شفافًا، لذا فإن تركيب لون أو تدرّج أو خلفية جديدة أمر تفعله في خط المعالجة الخاص بك — دون استدعاء ثانٍ للواجهة. كما يضم محرّر الويب من ImgGen مولّد خلفيات إن أردت خلفيات مولّدة بالذكاء الاصطناعي بدل موادك الخاصة.
ابدأ الآن
ابدأ استدعاء واجهة إزالة الخلفية
مفتاح واحد يفتح نقاط النهاية السبع جميعها. بلا علامة مائية، مع حقوق تجارية كاملة، ولا يُحفظ أي شيء ترسله بعد إرجاع الاستجابة.
احصل على مفتاح API