v1 · 7 نقاط نهاية · تعمل الآن
تحرير الصور
واجهة برمجية للمطوّرين
سبع نقاط نهاية لمعالجة الصور بالذكاء الاصطناعي خلف مفتاح API واحد: إزالة الخلفية، والتكبير، وإزالة العلامة المائية والنص، والترميم، والتلوين، وتحويل النص إلى صورة. REST بسيط، واستجابة JSON، ولا شيء يُخزَّن بعد انتهاء الاستدعاء.
- 7 نقاط نهاية، مفتاح واحد
- REST فوق HTTPS
- بلا علامة مائية
- لا نخزّن شيئًا
$ curl -X POST app.imggen.ai/v1/remove-background \
-H "Authorization: Bearer sk_live_..." \
-F image=@photo.jpg
→ 200 OK · 128 ms · X-Credit-Remaining: 385
{
"success": true,
"image": "iVBORw0KGgoAAAANSUhEUg..."
}ما هي واجهة تحرير الصور من ImgGen AI؟
واجهة تحرير الصور من ImgGen AI خدمة REST تنفّذ معالجة الصور بالذكاء الاصطناعي عند الطلب. ترسل صورة — أو موجّهًا نصيًا — إلى نقطة نهاية عبر HTTPS، فتعود النتيجة المعالَجة مُرمَّزة بـ base64 داخل استجابة JSON. لا نموذج تستضيفه ولا وحدة GPU تجهّزها.
تشترك كل نقاط النهاية في العنوان الأساسي نفسه، والمفتاح نفسه، وصيغة الاستجابة نفسها، لذا فإن إضافة إمكانية ثانية إلى سير عملك تعني تغيير المسار لا بناء تكامل جديد. وإذا أردت تجربة النماذج قبل كتابة أي كود، فالنماذج نفسها تشغّل أدوات ImgGen AI المجانية في المتصفح.
كيف أستخدم واجهة تحرير الصور؟
ولّد مفتاح API ثم أرسل طلب multipart يحمل صورتك. يزيل هذا المثال الخلفية؛ وتتبع بقية نقاط نهاية التحرير النمط نفسه بمسار مختلف. أما توليد الصور فهو الاستثناء الوحيد — إذ يستقبل جسم JSON يحوي الموجّه وعدد العيّنات ونسبة الأبعاد بدل ملف.
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 { image } = await res.json();
fs.writeFileSync('result.png', Buffer.from(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},
)
with open("result.png", "wb") as out:
out.write(base64.b64decode(res.json()["image"]))نقاط النهاية السبع
لكل واحدة صفحة مرجعية خاصة بها تضم المعاملات وأمثلة الكود بثلاث لغات وتكلفتها بالأرصدة بدقة.
واجهة إزالة الخلفية
أزل خلفيات الصور برمجيًا بطلب POST واحد. مفتاح API واحد، ومخرجات PNG شفافة، وخدمة عديمة الحالة لا تحفظ الصور التي ترسلها أبدًا.
واجهة تكبير الصور
ارفع دقة صورك مرتين أو أربع مرات من خادمك الخاص. تحسين الوجوه والحدّة اختياريان، والمخرجات JPEG أو PNG، والسعر يتدرّج مع المعامل الذي تطلبه.
واجهة إزالة العلامة المائية
اكتشف العلامات المائية في الصور وامحها في طلب واحد. يعيد الطلاء التوليدي بناء البكسلات خلف العلامة، وهذه هي نقطة النهاية الوحيدة التي تقبل أيضًا دفعة من الصور.
واجهة إزالة النص
امحُ الترجمات والطبقات النصية والطوابع الزمنية والعلامات المحروقة في الصورة، من الكود. الكشف تلقائي، ولا تُحتسب عليك تكلفة إن لم تحوِ الصورة نصًا.
واجهة ترميم الصور
رمّم الصور القديمة والتالفة والباهتة من خلفيتك الخاصة، مع تلوين ورفع دقة اختياريين في الطلب نفسه بدل ربط ثلاثة استدعاءات معًا.
واجهة تلوين الصور
حوّل الصور بالأبيض والأسود إلى صور ملوّنة بشكل طبيعي في طلب واحد، مع إصلاح اختياري للتمزّقات في الاستدعاء نفسه، ودون أي انتقاء يدوي للألوان.
واجهة توليد الصور بالذكاء الاصطناعي
ولّد صورًا من موجّه نصي بطلب JSON واحد. حتى أربع عيّنات لكل استدعاء، وثلاثة نماذج توازن بين السرعة والجودة، وحقوق تجارية كاملة على المخرجات.
كم تكلفة واجهة تحرير الصور؟
الاحتساب قائم على الأرصدة لا على رسم ثابت لكل استدعاء، لذا يكلّفك الشهر المزدحم والشهر الهادئ المبلغ نفسه لكل صورة. والأرصدة مشتركة بين كل نقاط النهاية ومحرّر الويب — رصيد واحد لا حصة منفصلة لكل أداة. ويُرد الاستدعاء الفاشل تلقائيًا، وتعيد كل استجابة ناجحة رصيدك المتبقي في ترويسة X-Credit-Remaining.
| نقطة النهاية | المسار | أرصدة / استدعاء |
|---|---|---|
| إزالة الخلفية | /v1/remove-background | 1 |
| تكبير الصور | /v1/upscale-image | 2–4 |
| إزالة العلامة المائية | /v1/remove-watermark | 2 |
| إزالة النص | /v1/remove-text | 2 |
| ترميم الصور | /v1/image-restoration | 2 |
| تلوين الصور | /v1/colorize-photo | 2 |
| توليد الصور | /v1/generate-image | 3+ |
| الخطة | السعر | الأرصدة | API | ملاحظات |
|---|---|---|---|---|
| Free | $0 | 50 رصيدًا مجانيًا لمرة واحدة | بلا وصول إلى الواجهة | لا حاجة لبطاقة ائتمان |
| Starter | $9.99 / month | 400 رصيد / شهر | الوصول إلى الواجهة مشمول | الأرصدة غير المستخدمة تُرحَّل |
| Pro | $29.99 / month | 1,400 رصيد / شهر | وصول إلى الواجهة + دعم ذو أولوية | الأرصدة غير المستخدمة تُرحَّل |
| Enterprise | Custom | حجم مخصص | بنية تحتية مخصصة | support@imggen.ai |
آخر تحقق من تكاليف الأرصدة والحدود 2026-08-27. كل التفاصيل في صفحة الأسعار.
كيف تعمل الواجهة
مملّة عن قصد: طلب واحد، واستجابة واحدة، ولا تنسيق مطلوب من جهتك.
تزامنية بلا طوابير
الصورة المعالَجة موجودة في جسم الاستجابة نفسها. لا معرّف مهمة تستعلم عنه، ولا نقطة webhook تجهّزها، ولا طابور توفّق بينه وبين شيء. وتخضع الطلبات لحد أقصى قدره 60 ثانية.
multipart دخولًا وbase64 خروجًا
أرسل صورة المدخل كنموذج multipart — صيغ JPEG (JPG) وPNG وWebP حتى 25 ميغابايت. وتعود النتيجة مُرمَّزة بـ base64 في جسم JSON: فُكّ ترميزها واكتبها حيث تخزّن ملفاتك.
لا احتساب إلا عند النجاح
تُخصم الأرصدة بشكل ذرّي وتُرد تلقائيًا إذا فشلت المعالجة، فلا يُحتسب عليك إلا ما عاد فعلًا من صور. بل إن إزالة النص تعيد 422 دون أي تكلفة حين لا يكون هناك نص لإزالته.
مفاتيح قابلة للتدوير
تُعرض المفاتيح مرة واحدة وتُخزَّن كتجزئة فقط. ويسري الإلغاء خلال دقيقة تقريبًا، فيصبح تسريب مفتاح مشكلة دقيقة واحدة لا حادثة أمنية.
هل تخزّن الواجهة صوري أو تتدرّب عليها؟
لا. الواجهة عديمة الحالة. فخلافًا لمحرّر الويب الذي يحفظ مشاريعك كي تعود إليها، لا ينشئ استدعاء الواجهة مشروعًا ولا سجل مهمة ولا ملفًا مخزَّنًا. يُكتب ما ترفعه في كائن مؤقت، ثم يُعالج، ثم يُحذف فور إرجاع الاستجابة. والشيء الوحيد الذي يبقى هو سجل استخدام يوثّق أن استدعاءً قد حدث وكم رصيدًا كلّف.
لا تُستخدم صورك أبدًا في تدريب النماذج. وهذا مهم إن كنت تعالج صور عملاء لا يحق لك تعاقديًا الاحتفاظ بها — فما يبقيها خارج تخزيننا هو البنية نفسها لا مجرد السياسة.
استجابات الخطأ
تعيد حالات الفشل غلافًا بصيغة JSON على النحو { "error": { "message", "code" } }، مع مطابقة حالة HTTP للرمز.
| الحالة | الرمز | المعنى |
|---|---|---|
| 401 | UNAUTHORIZED | مفتاح API مفقود أو غير صالح الصيغة أو تم إلغاؤه. |
| 402 | INSUFFICIENT_CREDITS | لا يملك حسابك أرصدة كافية لهذا الاستدعاء. |
| 403 | FORBIDDEN | خطتك لا تمنح وصولًا إلى هذه الأداة. |
| 404 | NOT_FOUND | مسار نقطة النهاية غير موجود. |
| 409 | CONFLICT | الطلب يتعارض مع الحالة الحالية للمورد. |
| 422 | VALIDATION_ERROR | رُفض الطلب — نوع ملف غير صالح، أو حقل ناقص، أو لا شيء لمعالجته. لا تُحتسب أي أرصدة. |
من يستخدم واجهة ImgGen؟
المواضع التي تثبت فيها واجهة معالجة الصور جدواها داخل منتج ما.
التجارة الإلكترونية والمتاجر
وحّد صور المورّدين والبائعين لحظة الرفع — افصل الخلفيات، وأزل النصوص المركّبة، وكبّر اللقطات القديمة منخفضة الدقة، حتى تبدو كل صفحة منتج وكأنها من الاستوديو نفسه.
الطباعة عند الطلب ونماذج المنتجات
اعزل التصميم، وارفع الدقة إلى معايير الطباعة، وركّبه على القوالب دون أن يلمس المصمم كل طلب على حدة.
منصات التصميم والتحرير
أطلق ميزات تحرير بنقرة واحدة داخل منتجك دون استضافة وحدات GPU أو ضبط النماذج أو صيانة بنية استدلال.
الأرشيف والأنساب والرقمنة
رمّم الصور الممسوحة ولوّنها وكبّرها ضمن خط معالجة آلي بدل تنقيح كل صورة يدويًا.
منصات المحتوى والنشر
ولّد صورًا أصلية من موجّه نصي، ونظّف ما يرفعه المساهمون ضمن سير عملك التحريري القائم.
الوكالات والأدوات الداخلية
أتمِت أعمال الصور المتكررة الواقعة بين موجز العميل والمادة النهائية، انطلاقًا من الأدوات التي يستخدمها فريقك أصلًا.
أسئلة شائعة عن واجهة تحرير الصور
- نعم. تتيح واجهة تحرير الصور من ImgGen AI سبع نقاط نهاية REST — إزالة الخلفية، وتكبير الصور، وإزالة العلامة المائية، وإزالة النص، وترميم الصور، والتلوين، وتوليد الصور من النص — جميعها على https://app.imggen.ai ويمكن الوصول إليها بمفتاح API واحد.
- تنفّذ تعديلًا محددًا على الصورة التي ترسلها وتعيد النتيجة في الاستجابة نفسها. يمكنك إزالة الخلفية للحصول على PNG شفاف، أو التكبير مرتين أو أربع مرات، أو محو العلامات المائية أو النص المحروق في الصورة، أو ترميم الصور التالفة وتلوينها، أو توليد صور جديدة من موجّه نصي.
- أنشئ حساب ImgGen على https://editor.imggen.ai ثم ولّد مفتاحًا من إعدادات الحساب. يُعرض المفتاح مرة واحدة ويُخزَّن كتجزئة فقط، لذا انسخه إلى مكان آمن: إن ضاع فستولّد مفتاحًا جديدًا بدل استرجاع القديم. ويسري إلغاء المفتاح خلال دقيقة تقريبًا.
- أرسل مفتاحك كرمز bearer في كل طلب: Authorization: Bearer sk_live_…. أما المفاتيح الصادرة قبل النظام الحالي فيمكنها المصادقة أيضًا عبر ترويسة x-imggen-key القديمة، وهي لا تزال مقبولة.
- يُقاس الاستخدام بالأرصدة لا برسم ثابت لكل استدعاء، وتختلف التكلفة بحسب نقطة النهاية: إزالة الخلفية برصيد واحد؛ وإزالة العلامة المائية وإزالة النص والترميم والتلوين برصيدين؛ والتكبير برصيدين عند factor=2 وبأربعة عند factor=4؛ ويبدأ توليد الصور من ثلاثة ويختلف بحسب النموذج. تمنحك خطة Starter 400 رصيد شهريًا مقابل 9.99 دولار، وPro 1,400 مقابل 29.99 دولار، مع ترحيل الأرصدة غير المستخدمة ما دام الاشتراك فعّالًا.
- يأتي حساب ImgGen المجاني بـ 50 رصيدًا دون بطاقة ائتمان، وهو ما يكفي لتقييم النماذج في أدوات الويب. أما الوصول إلى الواجهة نفسها فهو جزء من خطتَي Starter وPro المدفوعتين — لا توجد فئة مجانية دائمة للواجهة، ونفضّل قول ذلك صراحةً بدل الإعلان عن واحدة تُقيَّد لاحقًا بصمت.
- تقبل الواجهة ملفات JPEG (JPG) وPNG وWebP بحجم أقصاه 25 ميغابايت للصورة الواحدة. وتُعاد النتائج كصورة مُرمَّزة بـ base64 داخل استجابة JSON.
- تزامنية. لا معرّف مهمة تستعلم عنه، ولا طابور تديره، ولا webhook تضبطه — الصورة المعالَجة موجودة في جسم الاستجابة نفسها. وتخضع الطلبات لحد أقصى قدره 60 ثانية.
- لا. هذه الواجهة عديمة الحالة: فهي لا تنشئ مشروعًا، ولا تحفظ ملفًا، ولا تحتفظ بصورتك. يُكتب ما ترفعه في كائن مؤقت، ثم يُعالج، ثم يُحذف فور إرجاع الاستجابة. الشيء الوحيد الذي يبقى هو سجل استخدام يوثّق أن استدعاءً قد حدث وكم رصيدًا كلّف. لا تُستخدم صورك أبدًا في تدريب النماذج.
- نعم. كل الخطط، بما فيها المجانية، تشمل حقوق استخدام تجاري كاملة، ولا تحمل أي مخرجات علامة مائية. يمكنك بيع أي شيء تُعيده الواجهة أو طباعته أو نشره.
- تقبل نقطة نهاية إزالة العلامة المائية دفعة من الملفات عبر image[] وتعيد مصفوفة images. أما بقية نقاط النهاية فتعالج صورة واحدة لكل طلب — وللحجم الكبير، أرسل الطلبات على التوازي من عاملك الخاص، فكل استدعاء مستقل.
- ليس حاليًا. الواجهة عبارة عن REST بسيط فوق HTTPS مع رفع multipart، لذا يعمل معها أي عميل HTTP، ويقدّم التوثيق أمثلة جاهزة للنسخ بـ cURL وNode.js وPython. ولا توجد بعد مكتبة عميل رسمية ولا مواصفة OpenAPI منشورة.
ابدأ الآن
أول استدعاء خلال خمس دقائق
أنشئ مفتاحًا، وانسخ مثال cURL، وستجد إزالة الخلفية تعمل. مفتاح واحد يغطي نقاط النهاية السبع، في كل خطة تشمل الوصول إلى الواجهة.
احصل على مفتاح API