2 أرصدة لكل استدعاء

واجهة ترميم الصور

رمّم الصور القديمة والتالفة والباهتة من خلفيتك الخاصة، مع تلوين ورفع دقة اختياريين في الطلب نفسه بدل ربط ثلاثة استدعاءات معًا.

  • REST · JSON
  • بلا علامة مائية
  • لا نخزّن شيئًا
endpoint

POST /v1/image-restoration

العنوان الأساسي
https://app.imggen.ai
المصادقة
Authorization: Bearer sk_live_…
التكلفة
2 أرصدة
المدخلات
JPEG (JPG), PNG and WebP · max 25 MB

01 — نظرة عامة

ما هي واجهة ترميم الصور؟

واجهة ترميم الصور من ImgGen AI نقطة نهاية REST تصلح الصور التالفة. تقلّل الخدوش والتمزّقات والبقع وبهتان الألوان والضبابية، ويمكنها اختياريًا تلوين الأصول بالأبيض والأسود ورفع دقتها ضمن الاستدعاء نفسه. ترفع النسخة الممسوحة فتعود الصورة المرمَّمة في الاستجابة.

هذه إحدى نقاط النهاية السبع في واجهة تحرير الصور من ImgGen AI، وجميعها تشترك في مفتاح API واحد، وعنوان URL أساسي واحد، وصيغة الطلب والاستجابة نفسها. وإذا احتجت هذه الإمكانية داخل المتصفح لا من الكود، فالنموذج نفسه هو ما يشغّل أداة Image Restoration.

02 — الطلب

معاملات الطلب

أرسل طلب POST إلى https://app.imggen.ai/v1/image-restoration، مصادَقًا بمفتاح API في ترويسة Authorization.

المعاملات التي تقبلها نقطة النهاية هذه
المعاملالنوعمطلوبالافتراضيالوصف
imagefileمطلوبيضيف ألوانًا واقعية إلى الصور بالأبيض والأسود أثناء الترميم.
colorizebooleanاختياريfalseيصلح الخدوش والتمزّقات والتلف المادي.
removeTearsbooleanاختياريfalseيكبّر الصورة المرمَّمة لرفع دقتها. يضيف تكلفة التكبير إلى الاستدعاء.
enhanceResolutionbooleanاختياريfalseUpscale the restored image for extra resolution. Adds the upscaler cost to the call.
03 — الدمج

كيف أدمج واجهة ترميم الصور؟

أنشئ مفتاح 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=false
04 — الاستجابة

الاستجابة

يعيد الاستدعاء الناجح استجابة JSON. والنتيجة مُرمَّزة بـ base64 — فُكّ ترميزها قبل كتابتها على القرص أو في تخزين الكائنات. كما تحمل كل استجابة ناجحة ترويسة X-Credit-Remaining برصيدك بعد الاستدعاء.

{
  "success": true,
  "message": "Image restored successfully",
  "image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}
05 — الحدود

حدود وسلوكيات يُستحسن معرفتها

تقبل نقطة النهاية صيغ JPEG (JPG) وPNG وWebP بحجم ملف أقصاه 25 ميغابايت، وتستجيب تزامنيًا خلال 60 ثانية — لا مهمة تستعلم عنها ولا webhook تضبطه.

ثلاث عمليات، استدعاء واحد

الترميم والتلوين والتكبير معاملات في الطلب نفسه لا نقاط نهاية منفصلة، فيتم الترميم الكامل في رحلة واحدة بدل ثلاث.

enhanceResolution يكلّف أكثر

تفعيل enhanceResolution يشغّل نموذج التكبير أيضًا، فتُضاف تكلفة التكبير فوق رسم الترميم الأساسي.

جودة المسح مهمة

النموذج يعيد البناء مما يراه. المسح المسطّح جيد الإضاءة بأعلى دقة يدعمها جهازك يعطي نتائج أفضل بوضوح من صورة ملتقطة بالهاتف للنسخة المطبوعة.

06 — في الإنتاج

فيمَ تُستخدم واجهة ترميم الصور؟

حيث تضع الفرق نقطة النهاية هذه في الإنتاج لمعالجة الصور برمجيًا وعلى نطاق واسع.

منصات الأنساب والأرشيف

قدّم ترميمًا بنقرة واحدة لصور العائلة التي يرفعها مستخدموك، دون بناء نموذج ترميم أو تشغيله بنفسك.

خدمات الرقمنة

شغّل الترميم تلقائيًا فور خروج النسخ الممسوحة، ليراجع الموظفون النتائج بدل تحرير كل صورة يدويًا.

مقتنيات المتاحف والمكتبات

أنتج نسخ عرض مقروءة من المواد المصوّرة التالفة مع إبقاء الأصول كما هي دون مساس.

منتجات الطباعة الفوتوغرافية

رمّم صور العملاء المرفوعة وكبّرها في استدعاء واحد قبل إرسالها إلى الطباعة.

07 — التكلفة

كم تكلفة واجهة ترميم الصور؟

يكلّف كل استدعاء ناجح 2 أرصدة، وبذلك تتبع تكلفتك الفعلية لكل صورة الخطة التي تشترك بها. تأتي الأرصدة من خطتك وهي مشتركة بين كل نقاط النهاية ومحرّر الويب، فلا تشتري حصة منفصلة لكل أداة. ويُرد الاستدعاء الفاشل تلقائيًا. اطّلع على كل التفاصيل في صفحة الأسعار.

خطط ImgGen AI والوصول إلى الواجهة
الخطةالسعرالأرصدةAPI
Free$050 رصيدًا مجانيًا لمرة واحدةبلا وصول إلى الواجهة
Starter$9.99 / month400 رصيد / شهرالوصول إلى الواجهة مشمول
Pro$29.99 / month1,400 رصيد / شهروصول إلى الواجهة + دعم ذو أولوية
EnterpriseCustomحجم مخصصبنية تحتية مخصصة

آخر تحقق من تكاليف الأرصدة والحدود 2026-08-27.

08 — ذات صلة

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

واجهة تلوين الصورواجهة تكبير الصورImage Restoration (أداة الويب)كل نقاط نهاية الواجهة

متاح أيضًا: إزالة الخلفية, إزالة العلامة المائية, إزالة النص, توليد الصور.

FAQ

أسئلة شائعة عن واجهة ترميم الصور

هي نقطة نهاية HTTP ترمّم الصور التالفة تلقائيًا: تقلّل الخدوش والتمزّقات والبقع وبهتان الألوان والضبابية، ويمكنها اختياريًا تلوين النتيجة وتكبيرها. وجودها يتيح لمنتجك تقديم ميزة الترميم لمستخدميه دون أن ينقّح أحد الصور يدويًا.

ابدأ الآن

ابدأ استدعاء واجهة ترميم الصور

مفتاح واحد يفتح نقاط النهاية السبع جميعها. بلا علامة مائية، مع حقوق تجارية كاملة، ولا يُحفظ أي شيء ترسله بعد إرجاع الاستجابة.

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