2–4 أرصدة لكل استدعاء
واجهة تكبير الصور
ارفع دقة صورك مرتين أو أربع مرات من خادمك الخاص. تحسين الوجوه والحدّة اختياريان، والمخرجات JPEG أو PNG، والسعر يتدرّج مع المعامل الذي تطلبه.
- REST · JSON
- بلا علامة مائية
- لا نخزّن شيئًا
POST /v1/upscale-image
ما هي واجهة تكبير الصور؟
واجهة تكبير الصور من ImgGen AI نقطة نهاية REST ترفع دقة الصورة بالذكاء الاصطناعي لا بالاستيفاء البسيط. فهي تعيد بناء الحواف والملمس والتفاصيل الدقيقة بدل تمديد البكسلات، فتبقى المخرجات حادة. ترسل صورة ومعامل تكبير، فتعود النتيجة الأعلى دقة في الطلب نفسه.
هذه إحدى نقاط النهاية السبع في واجهة تحرير الصور من ImgGen AI، وجميعها تشترك في مفتاح API واحد، وعنوان URL أساسي واحد، وصيغة الطلب والاستجابة نفسها. وإذا احتجت هذه الإمكانية داخل المتصفح لا من الكود، فالنموذج نفسه هو ما يشغّل أداة AI Image Upscaler.
معاملات الطلب
أرسل طلب POST إلى https://app.imggen.ai/v1/upscale-image، مصادَقًا بمفتاح API في ترويسة Authorization.
| المعامل | النوع | مطلوب | الافتراضي | الوصف |
|---|---|---|---|---|
| image | file | مطلوب | — | معامل التكبير. يقبل 2 أو 4. |
| factor | number | اختياري | 4 | يطبّق إعادة بناء إضافية للوجوه. مفيد للصور الشخصية والجماعية. |
| enhanceFace | boolean | اختياري | false | يطبّق حدّة إضافية على النتيجة المكبَّرة. |
| sharpen | boolean | اختياري | false | صيغة المخرجات. تقبل jpeg أو png. |
| output | string | اختياري | jpeg | Output format. Accepts jpeg or png. |
كيف أدمج واجهة تكبير الصور؟
أنشئ مفتاح API في حسابك على ImgGen، واضبطه كمتغير بيئة، ثم استدعِ نقطة النهاية. هذا هو الطلب نفسه بـ cURL وNode.js وPython.
curl --request POST \
--url 'https://app.imggen.ai/v1/upscale-image' \
--header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
--form image=@/path/to/photo.jpg \
--form factor=4 \
--form enhanceFace=false \
--form sharpen=false \
--form output=jpegimport fs from 'node:fs';
const form = new FormData();
form.append('image', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');
form.append('factor', '4');
form.append('enhanceFace', 'false');
form.append('sharpen', 'false');
form.append('output', 'jpeg');
const res = await fetch('https://app.imggen.ai/v1/upscale-image', {
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/upscale-image",
headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
files={"image": f},
data={"factor": "4", "enhanceFace": "false", "sharpen": "false", "output": "jpeg"},
)
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 upscaled successfully",
"image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}حدود وسلوكيات يُستحسن معرفتها
تقبل نقطة النهاية صيغ JPEG (JPG) وPNG وWebP بحجم ملف أقصاه 25 ميغابايت، وتستجيب تزامنيًا خلال 60 ثانية — لا مهمة تستعلم عنها ولا webhook تضبطه.
اختر صيغة مخرجاتك
اضبط output=png حين تحتاج نتيجة بلا فقدان أو تريد الإبقاء على قناة ألفا؛ أما jpeg فيبقي حجم الاستجابة صغيرًا في أعمال الكتالوجات الكبيرة.
تحسين الوجوه اختياري
يُجري enhanceFace إعادة بناء إضافية للوجوه لتحسين الصور الشخصية أثناء تكبيرها. أبقِه معطّلًا في صور المنتجات والمناظر حيث لا وجه لتحسينه.
Synchronous by design
There is no job queue to poll. The upscaled image comes back in the same response, within the 60-second request ceiling.
فيمَ تُستخدم واجهة تكبير الصور؟
حيث تضع الفرق نقطة النهاية هذه في الإنتاج لمعالجة الصور برمجيًا وعلى نطاق واسع.
ترحيل الكتالوجات القديمة
ارفع سنوات من صور المنتجات الصغيرة ومنخفضة الدقة إلى معايير العرض عالية الدقة اليوم عبر معالجة دفعية، بدل إعادة تصويرها.
التحضير للطباعة
ارفع المواد المعدّة للويب إلى مقاس عالي الجودة يصمد في الطباعة، مع حدّة اختيارية في الاستدعاء نفسه لنتيجة أوضح.
المحتوى الذي ينشئه المستخدمون
كبّر الصور الرمزية والملفات المرفوعة الصغيرة على الخادم لتظهر نظيفة على الشاشات عالية الكثافة.
الإعلام والأرشيف
ارفع دقة الصور الممسوحة أو المضغوطة قبل دخولها نظام إدارة المحتوى، مع الترميم عند الحاجة.
كم تكلفة واجهة تكبير الصور؟
يكلّف كل استدعاء ناجح 2–4 أرصدة، وبذلك تتبع تكلفتك الفعلية لكل صورة الخطة التي تشترك بها. تأتي الأرصدة من خطتك وهي مشتركة بين كل نقاط النهاية ومحرّر الويب، فلا تشتري حصة منفصلة لكل أداة. ويُرد الاستدعاء الفاشل تلقائيًا. اطّلع على كل التفاصيل في صفحة الأسعار.
| الخطة | السعر | الأرصدة | API |
|---|---|---|---|
| Free | $0 | 50 رصيدًا مجانيًا لمرة واحدة | بلا وصول إلى الواجهة |
| Starter | $9.99 / month | 400 رصيد / شهر | الوصول إلى الواجهة مشمول |
| Pro | $29.99 / month | 1,400 رصيد / شهر | وصول إلى الواجهة + دعم ذو أولوية |
| Enterprise | Custom | حجم مخصص | بنية تحتية مخصصة |
آخر تحقق من تكاليف الأرصدة والحدود 2026-08-27.
نقاط نهاية وأدوات ذات صلة
الفرق التي تستخدم واجهة تكبير الصور عادةً ما تلجأ إلى هذه بعدها.
متاح أيضًا: إزالة الخلفية, إزالة العلامة المائية, إزالة النص, توليد الصور.
أسئلة شائعة عن واجهة تكبير الصور
- هي نقطة نهاية HTTP ترفع دقة الصورة باستخدام نموذج مدرَّب. فبدل الاستيفاء بين البكسلات الموجودة كما يفعل تغيير الحجم، يتوقّع النموذج التفاصيل التي كانت ستحويها نسخة أعلى دقة من الصورة — الحواف والملمس والبنية — ثم يعيد بناءها. ترسل الصورة عبر POST وتقرأ النتيجة المكبَّرة من الاستجابة.
- يقبل المعامل factor القيمتين 2 أو 4 وقيمته الافتراضية 4. ويمكن أن تكون المدخلات JPEG (JPG) أو PNG أو WebP حتى 25 ميغابايت، وتُعاد المخرجات بصيغة jpeg (الافتراضية) أو png.
- تتبع التكلفة المعامل: رصيدان عند factor=2 وأربعة عند factor=4 (القيمة الافتراضية). تمنحك خطة Starter 400 رصيد شهريًا مقابل 9.99 دولار، وPro 1,400 مقابل 29.99 دولار، وتُرحَّل الأرصدة غير المستخدمة ما دمت مشتركًا. والتسعير بالأرصدة يعني أن الشهر الكثيف والشهر الهادئ يكلّفانك المبلغ نفسه لكل صورة.
- يعيد التكبير بناء التفاصيل أثناء التوسيع، فيزيد ضمنًا من حدّة الصور الباهتة، ويدفع المعامل sharpen هذا الأثر أبعد. أما الصور التالفة أو الباهتة اللون — الخدوش والتمزّقات وفقدان اللون — فاستخدم لها واجهة ترميم الصور، فهي مصمّمة للإصلاح لا لرفع الدقة.
- تزامني. لا معرّف مهمة تستعلم عنه ولا webhook تضبطه — الصورة المكبَّرة موجودة في جسم الاستجابة نفسها، بحد أقصى 60 ثانية لكل طلب.
- نعم. كل الخطط، بما فيها المجانية، تشمل حقوق استخدام تجاري كاملة، ولا تحمل أي مخرجات علامة مائية. يمكنك بيع أي شيء تُعيده الواجهة أو طباعته أو نشره.
- لا. هذه الواجهة عديمة الحالة: فهي لا تنشئ مشروعًا، ولا تحفظ ملفًا، ولا تحتفظ بصورتك. يُكتب ما ترفعه في كائن مؤقت، ثم يُعالج، ثم يُحذف فور إرجاع الاستجابة. الشيء الوحيد الذي يبقى هو سجل استخدام يوثّق أن استدعاءً قد حدث وكم رصيدًا كلّف. لا تُستخدم صورك أبدًا في تدريب النماذج.
ابدأ الآن
ابدأ استدعاء واجهة تكبير الصور
مفتاح واحد يفتح نقاط النهاية السبع جميعها. بلا علامة مائية، مع حقوق تجارية كاملة، ولا يُحفظ أي شيء ترسله بعد إرجاع الاستجابة.
احصل على مفتاح API