ما مدى دقة الألوان؟

معقولة أكثر منها موثّقة. النموذج لا يعرف لون تلك السترة فعلًا عام 1953؛ إنه يقدّم التلوين الأرجح استنادًا إلى كل ما يراه. درجات البشرة والنباتات والسماء مقنعة عادةً لأن مداها ضيق؛ أما الملابس والأسطح المطلية وأي شيء لونه اعتباطي فهو تخمين مدروس. وإن كان العمل تاريخيًا، فقدّم النتائج على أنها تفسير.

كم تكلفة التلوين؟

رصيدان لكل استدعاء ناجح. تشمل خطة Starter 400 رصيد شهريًا مقابل 9.99 دولار، وPro 1,400 مقابل 29.99 دولار، وتُرحَّل الأرصدة غير المستخدمة ما دام الاشتراك فعّالًا.

كيف أدمج واجهة التلوين في تطبيقي؟

أنشئ مفتاح API في حسابك على ImgGen، ثم أرسل عبر POST نموذج multipart يحوي حقل image إلى https://app.imggen.ai/v1/colorize-photo مع ترويسة Authorization: Bearer. فُكّ ترميز حقل image بـ base64 من استجابة JSON واحفظه حيث تخزّن أصولك. وتجد في هذه الصفحة أمثلة بـ cURL وNode.js وPython.

ما الفرق بينها وبين واجهة الترميم؟

هذه النقطة مبنية لإضافة اللون ويمكنها اختياريًا إصلاح التمزّقات. أما نقطة الترميم فمبنية لإصلاح التلف ويمكنها اختياريًا إضافة اللون. استخدم الترميم إن كانت الصورة تالفة أساسًا، واستخدم هذه إن كانت بالأبيض والأسود فحسب.

ما الصيغ والأحجام المدعومة؟

تقبل الواجهة ملفات JPEG (JPG) وPNG وWebP بحجم أقصاه 25 ميغابايت للصورة الواحدة. وتُعاد النتائج كصورة مُرمَّزة بـ base64 داخل استجابة JSON.

هل تخزّنون الصور التي أرسلها؟

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

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

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

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

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

احصل على مفتاح API اطّلع على التوثيق

endpoint

POST /v1/colorize-photo

العنوان الأساسي: 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 أساسي واحد، وصيغة الطلب والاستجابة نفسها. وإذا احتجت هذه الإمكانية داخل المتصفح لا من الكود، فالنموذج نفسه هو ما يشغّل أداة Colorize Photo.

02 — الطلب

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

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

المعاملات التي تقبلها نقطة النهاية هذه
المعامل	النوع	مطلوب	الافتراضي	الوصف
image	file	مطلوب	—	يصلح الخدوش والتمزّقات أثناء التلوين.
removeTears	boolean	اختياري	false	Repair scratches and tears while colorizing.

03 — الدمج

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

أنشئ مفتاح API في حسابك على ImgGen، واضبطه كمتغير بيئة، ثم استدعِ نقطة النهاية. هذا هو الطلب نفسه بـ cURL وNode.js وPython.

curl --request POST \
  --url 'https://app.imggen.ai/v1/colorize-photo' \
  --header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
  --form image=@/path/to/photo.jpg \
  --form removeTears=false

import fs from 'node:fs';

const form = new FormData();
form.append('image', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');
form.append('removeTears', 'false');

const res = await fetch('https://app.imggen.ai/v1/colorize-photo', {
  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/colorize-photo",
        headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
        files={"image": f},
    data={"removeTears": "false"},
    )

data = res.json()
with open("result.png", "wb") as out:
    out.write(base64.b64decode(data["image"]))

04 — الاستجابة

الاستجابة

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

{
  "success": true,
  "message": "Image colorized successfully",
  "image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}

05 — الحدود

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

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

اللون مستنتج لا مستعاد

يتوقّع النموذج ألوانًا معقولة انطلاقًا من محتوى الصورة. النتيجة تفسير مقنع لا مرجع موثّق تاريخيًا، ومن الأفضل توضيح ذلك إن كنت تعرض المخرجات على مستخدميك.

لوّن ورمّم معًا

يضبط removeTears=true إصلاح الخدوش والتلف المادي ضمن العملية نفسها، دون استدعاء ثانٍ لنقطة نهاية الترميم.

الصور الملوّنة أصلًا

صُمّمت هذه النقطة لمدخلات بتدرّج الرمادي. إرسال صورة ملوّنة أصلًا لا معنى له؛ استخدم نقطة نهاية الترميم إن كان الترميم هو ما تريده.

06 — في الإنتاج

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

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

منتجات تاريخ العائلة

قدّم تلوين الصور الموروثة داخل تطبيقك كترقية مدفوعة أو ميزة تعزّز التفاعل.

التحرير والنشر

أنتج نسخًا ملوّنة من صور الأرشيف للتقارير المطوّلة والمواد الاستعادية، مع الإفصاح عن كونها تفسيرًا.

المعالجة الأرشيفية الكبيرة

أنشئ نسخ عرض ملوّنة لمقتنيات كاملة بتدرّج الرمادي مع الحفاظ على الأصول كما هي.

خدمات التذكار والهدايا

لوّن ورمّم صور العملاء المرفوعة تلقائيًا كجزء من تنفيذ الطلب.

07 — التكلفة

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

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

خطط ImgGen AI والوصول إلى الواجهة
الخطة	السعر	الأرصدة	API
Free	$0	50 رصيدًا مجانيًا لمرة واحدة	بلا وصول إلى الواجهة
Starter	$9.99 / month	400 رصيد / شهر	الوصول إلى الواجهة مشمول
Pro	$29.99 / month	1,400 رصيد / شهر	وصول إلى الواجهة + دعم ذو أولوية
Enterprise	Custom	حجم مخصص	بنية تحتية مخصصة

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

08 — ذات صلة

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

→واجهة ترميم الصور →واجهة تكبير الصور Colorize Photo (أداة الويب)كل نقاط نهاية الواجهة

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

FAQ

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

: هي نقطة نهاية HTTP تستقبل صورة بالأبيض والأسود وتعيد نسخة ملوّنة منها. يقرأ النموذج محتوى الصورة — الوجوه والملابس والنباتات والسماء والمواد — ويتوقّع الألوان المناسبة لها، فتحصل على نتيجة طبيعية دون تحديد أي لوحة ألوان.
: معقولة أكثر منها موثّقة. النموذج لا يعرف لون تلك السترة فعلًا عام 1953؛ إنه يقدّم التلوين الأرجح استنادًا إلى كل ما يراه. درجات البشرة والنباتات والسماء مقنعة عادةً لأن مداها ضيق؛ أما الملابس والأسطح المطلية وأي شيء لونه اعتباطي فهو تخمين مدروس. وإن كان العمل تاريخيًا، فقدّم النتائج على أنها تفسير.
: رصيدان لكل استدعاء ناجح. تشمل خطة Starter 400 رصيد شهريًا مقابل 9.99 دولار، وPro 1,400 مقابل 29.99 دولار، وتُرحَّل الأرصدة غير المستخدمة ما دام الاشتراك فعّالًا.
: أنشئ مفتاح API في حسابك على ImgGen، ثم أرسل عبر POST نموذج multipart يحوي حقل image إلى https://app.imggen.ai/v1/colorize-photo مع ترويسة Authorization: Bearer. فُكّ ترميز حقل image بـ base64 من استجابة JSON واحفظه حيث تخزّن أصولك. وتجد في هذه الصفحة أمثلة بـ cURL وNode.js وPython.
: هذه النقطة مبنية لإضافة اللون ويمكنها اختياريًا إصلاح التمزّقات. أما نقطة الترميم فمبنية لإصلاح التلف ويمكنها اختياريًا إضافة اللون. استخدم الترميم إن كانت الصورة تالفة أساسًا، واستخدم هذه إن كانت بالأبيض والأسود فحسب.
: تقبل الواجهة ملفات JPEG (JPG) وPNG وWebP بحجم أقصاه 25 ميغابايت للصورة الواحدة. وتُعاد النتائج كصورة مُرمَّزة بـ base64 داخل استجابة JSON.
: لا. هذه الواجهة عديمة الحالة: فهي لا تنشئ مشروعًا، ولا تحفظ ملفًا، ولا تحتفظ بصورتك. يُكتب ما ترفعه في كائن مؤقت، ثم يُعالج، ثم يُحذف فور إرجاع الاستجابة. الشيء الوحيد الذي يبقى هو سجل استخدام يوثّق أن استدعاءً قد حدث وكم رصيدًا كلّف. لا تُستخدم صورك أبدًا في تدريب النماذج.

ابدأ الآن

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

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

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