2 أرصدة لكل استدعاء
واجهة ترميم الصور
رمّم الصور القديمة والتالفة والباهتة من خلفيتك الخاصة، مع تلوين ورفع دقة اختياريين في الطلب نفسه بدل ربط ثلاثة استدعاءات معًا.
- REST · JSON
- بلا علامة مائية
- لا نخزّن شيئًا
POST /v1/image-restoration
ما هي واجهة ترميم الصور؟
واجهة ترميم الصور من ImgGen AI نقطة نهاية REST تصلح الصور التالفة. تقلّل الخدوش والتمزّقات والبقع وبهتان الألوان والضبابية، ويمكنها اختياريًا تلوين الأصول بالأبيض والأسود ورفع دقتها ضمن الاستدعاء نفسه. ترفع النسخة الممسوحة فتعود الصورة المرمَّمة في الاستجابة.
هذه إحدى نقاط النهاية السبع في واجهة تحرير الصور من ImgGen AI، وجميعها تشترك في مفتاح API واحد، وعنوان URL أساسي واحد، وصيغة الطلب والاستجابة نفسها. وإذا احتجت هذه الإمكانية داخل المتصفح لا من الكود، فالنموذج نفسه هو ما يشغّل أداة Image Restoration.
معاملات الطلب
أرسل طلب POST إلى https://app.imggen.ai/v1/image-restoration، مصادَقًا بمفتاح API في ترويسة Authorization.
| المعامل | النوع | مطلوب | الافتراضي | الوصف |
|---|---|---|---|---|
| image | file | مطلوب | — | يضيف ألوانًا واقعية إلى الصور بالأبيض والأسود أثناء الترميم. |
| colorize | boolean | اختياري | false | يصلح الخدوش والتمزّقات والتلف المادي. |
| removeTears | boolean | اختياري | false | يكبّر الصورة المرمَّمة لرفع دقتها. يضيف تكلفة التكبير إلى الاستدعاء. |
| enhanceResolution | boolean | اختياري | false | Upscale the restored image for extra resolution. Adds the upscaler cost to the call. |
كيف أدمج واجهة ترميم الصور؟
أنشئ مفتاح API في حسابك على ImgGen، واضبطه كمتغير بيئة، ثم استدعِ نقطة النهاية. هذا هو الطلب نفسه بـ cURL وNode.js وPython.
curl --request POST \
--url 'https://app.imggen.ai/v1/image-restoration' \
--header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
--form image=@/path/to/photo.jpg \
--form colorize=false \
--form removeTears=true \
--form enhanceResolution=falseimport fs from 'node:fs';
const form = new FormData();
form.append('image', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');
form.append('colorize', 'false');
form.append('removeTears', 'true');
form.append('enhanceResolution', 'false');
const res = await fetch('https://app.imggen.ai/v1/image-restoration', {
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/image-restoration",
headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
files={"image": f},
data={"colorize": "false", "removeTears": "true", "enhanceResolution": "false"},
)
data = res.json()
with open("result.png", "wb") as out:
out.write(base64.b64decode(data["image"]))الاستجابة
يعيد الاستدعاء الناجح استجابة JSON. والنتيجة مُرمَّزة بـ base64 — فُكّ ترميزها قبل كتابتها على القرص أو في تخزين الكائنات. كما تحمل كل استجابة ناجحة ترويسة X-Credit-Remaining برصيدك بعد الاستدعاء.
{
"success": true,
"message": "Image restored successfully",
"image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}حدود وسلوكيات يُستحسن معرفتها
تقبل نقطة النهاية صيغ JPEG (JPG) وPNG وWebP بحجم ملف أقصاه 25 ميغابايت، وتستجيب تزامنيًا خلال 60 ثانية — لا مهمة تستعلم عنها ولا webhook تضبطه.
ثلاث عمليات، استدعاء واحد
الترميم والتلوين والتكبير معاملات في الطلب نفسه لا نقاط نهاية منفصلة، فيتم الترميم الكامل في رحلة واحدة بدل ثلاث.
enhanceResolution يكلّف أكثر
تفعيل enhanceResolution يشغّل نموذج التكبير أيضًا، فتُضاف تكلفة التكبير فوق رسم الترميم الأساسي.
جودة المسح مهمة
النموذج يعيد البناء مما يراه. المسح المسطّح جيد الإضاءة بأعلى دقة يدعمها جهازك يعطي نتائج أفضل بوضوح من صورة ملتقطة بالهاتف للنسخة المطبوعة.
فيمَ تُستخدم واجهة ترميم الصور؟
حيث تضع الفرق نقطة النهاية هذه في الإنتاج لمعالجة الصور برمجيًا وعلى نطاق واسع.
منصات الأنساب والأرشيف
قدّم ترميمًا بنقرة واحدة لصور العائلة التي يرفعها مستخدموك، دون بناء نموذج ترميم أو تشغيله بنفسك.
خدمات الرقمنة
شغّل الترميم تلقائيًا فور خروج النسخ الممسوحة، ليراجع الموظفون النتائج بدل تحرير كل صورة يدويًا.
مقتنيات المتاحف والمكتبات
أنتج نسخ عرض مقروءة من المواد المصوّرة التالفة مع إبقاء الأصول كما هي دون مساس.
منتجات الطباعة الفوتوغرافية
رمّم صور العملاء المرفوعة وكبّرها في استدعاء واحد قبل إرسالها إلى الطباعة.
كم تكلفة واجهة ترميم الصور؟
يكلّف كل استدعاء ناجح 2 أرصدة، وبذلك تتبع تكلفتك الفعلية لكل صورة الخطة التي تشترك بها. تأتي الأرصدة من خطتك وهي مشتركة بين كل نقاط النهاية ومحرّر الويب، فلا تشتري حصة منفصلة لكل أداة. ويُرد الاستدعاء الفاشل تلقائيًا. اطّلع على كل التفاصيل في صفحة الأسعار.
| الخطة | السعر | الأرصدة | API |
|---|---|---|---|
| Free | $0 | 50 رصيدًا مجانيًا لمرة واحدة | بلا وصول إلى الواجهة |
| Starter | $9.99 / month | 400 رصيد / شهر | الوصول إلى الواجهة مشمول |
| Pro | $29.99 / month | 1,400 رصيد / شهر | وصول إلى الواجهة + دعم ذو أولوية |
| Enterprise | Custom | حجم مخصص | بنية تحتية مخصصة |
آخر تحقق من تكاليف الأرصدة والحدود 2026-08-27.
نقاط نهاية وأدوات ذات صلة
الفرق التي تستخدم واجهة ترميم الصور عادةً ما تلجأ إلى هذه بعدها.
متاح أيضًا: إزالة الخلفية, إزالة العلامة المائية, إزالة النص, توليد الصور.
أسئلة شائعة عن واجهة ترميم الصور
- هي نقطة نهاية HTTP ترمّم الصور التالفة تلقائيًا: تقلّل الخدوش والتمزّقات والبقع وبهتان الألوان والضبابية، ويمكنها اختياريًا تلوين النتيجة وتكبيرها. وجودها يتيح لمنتجك تقديم ميزة الترميم لمستخدميه دون أن ينقّح أحد الصور يدويًا.
- نعم. اضبط colorize=true فيضيف النموذج ألوانًا واقعية ضمن عملية الترميم نفسها. وإن كنت تريد اللون فقط والصورة غير تالفة، فنقطة نهاية التلوين المخصصة أرخص وأكثر مباشرةً.
- رصيدان لكل استدعاء ناجح. وضبط enhanceResolution=true يضيف تكلفة التكبير لأنه يشغّل نموذجًا ثانيًا. تشمل خطة Starter 400 رصيد شهريًا مقابل 9.99 دولار، وPro 1,400 مقابل 29.99 دولار، وتُرحَّل الأرصدة غير المستخدمة ما دام الاشتراك فعّالًا.
- الخدوش والتمزّقات والبقع وعلامات الماء وبهتان الألوان والاصفرار والضبابية العامة. حدّد removeTears=true تحديدًا للتلف المادي. أما المناطق التي فُقد محتواها الأصلي كليًا فتُعاد بناؤها بشكل معقول لا مستعاد؛ فالنموذج يستنتج ولا يعكس الزمن.
- قد يحدث، وهو أمر يستحق أن تفهمه قبل عرض النتائج على مستخدميك. فالنموذج يعيد بناء المعلومات الغائبة بالاستنتاج، ما يعني أن الوجوه شديدة التلف أو المنخفضة الدقة قد تعود مختلفة اختلافًا طفيفًا عن الشخص في الأصل. إنه يعمل مما يراه، ويقدّم تخمينًا معقولًا حيث لا يرى شيئًا. تعامل مع المخرجات كتفسير مرمَّم لا كأصل مستعاد.
- صورة واحدة لكل طلب. لا توجد صيغة دفعية لهذه النقطة — إزالة العلامة المائية وحدها تدعم image[]. ولمعالجة أرشيف كامل، أرسل الطلبات على التوازي من عاملك الخاص؛ فكل طلب مستقل ويُحتسب على حدة.
- تقبل الواجهة ملفات JPEG (JPG) وPNG وWebP بحجم أقصاه 25 ميغابايت للصورة الواحدة. وتُعاد النتائج كصورة مُرمَّزة بـ base64 داخل استجابة JSON.
- لا. هذه الواجهة عديمة الحالة: فهي لا تنشئ مشروعًا، ولا تحفظ ملفًا، ولا تحتفظ بصورتك. يُكتب ما ترفعه في كائن مؤقت، ثم يُعالج، ثم يُحذف فور إرجاع الاستجابة. الشيء الوحيد الذي يبقى هو سجل استخدام يوثّق أن استدعاءً قد حدث وكم رصيدًا كلّف. لا تُستخدم صورك أبدًا في تدريب النماذج.
- نعم. كل الخطط، بما فيها المجانية، تشمل حقوق استخدام تجاري كاملة، ولا تحمل أي مخرجات علامة مائية. يمكنك بيع أي شيء تُعيده الواجهة أو طباعته أو نشره.
ابدأ الآن
ابدأ استدعاء واجهة ترميم الصور
مفتاح واحد يفتح نقاط النهاية السبع جميعها. بلا علامة مائية، مع حقوق تجارية كاملة، ولا يُحفظ أي شيء ترسله بعد إرجاع الاستجابة.
احصل على مفتاح API