من 3 أرصدة لكل استدعاء

واجهة توليد الصور بالذكاء الاصطناعي

ولّد صورًا من موجّه نصي بطلب JSON واحد. حتى أربع عيّنات لكل استدعاء، وثلاثة نماذج توازن بين السرعة والجودة، وحقوق تجارية كاملة على المخرجات.

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

POST /v1/generate-image

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

01 — نظرة عامة

ما هي واجهة توليد الصور بالذكاء الاصطناعي؟

واجهة توليد الصور من ImgGen AI نقطة نهاية REST تحوّل الموجّهات النصية إلى صور. ترسل جسم JSON يحوي موجّهك وعدد العيّنات المطلوبة ونسبة الأبعاد والنموذج المستخدم، فتعود الصور المولَّدة كمصفوفة مُرمَّزة بـ base64. وهي نقطة النهاية الوحيدة التي تستقبل JSON بدل ملف.

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

02 — الطلب

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

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

المعاملات التي تقبلها نقطة النهاية هذه
المعاملالنوعمطلوبالافتراضيالوصف
promptstringمطلوبوصف نصي للصورة المراد توليدها.
samplesnumberاختياري1عدد الصور المولَّدة، من 1 إلى 4.
aspect_ratiostringاختياريsquareشكل المخرجات. يقبل square أو portrait أو landscape.
modelstringاختياريimggen-baseنموذج التوليد. يقبل imggen-base أو imggen-base-fast أو imggen-xl.
03 — الدمج

كيف أدمج واجهة توليد الصور بالذكاء الاصطناعي؟

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

curl --request POST \
  --url 'https://app.imggen.ai/v1/generate-image' \
  --header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "prompt": "close up photo of a rabbit in a wildflower meadow",
    "samples": 1,
    "aspect_ratio": "square",
    "model": "imggen-base"
  }'
04 — الاستجابة

الاستجابة

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

{
  "success": true,
  "message": "Images generated successfully",
  "images": ["iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="]
}
05 — الحدود

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

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

تُعيد مصفوفة images

خلافًا لنقاط التحرير التي تعيد حقل image مفردًا، يعيد التوليد images: مصفوفة تضم عنصرًا لكل عيّنة طلبتها.

ثلاثة نماذج

imggen-base هو التوازن الافتراضي، وimggen-base-fast يقايض بعض التفاصيل بالسرعة، وimggen-xl يستهدف أعلى جودة. الاختيار لكل طلب لا لكل حساب.

JSON لا multipart

هذه هي نقطة النهاية الوحيدة التي تستقبل جسم JSON. أرسل Content-Type: application/json بدل نموذج multipart.

06 — في الإنتاج

فيمَ تُستخدم واجهة توليد الصور بالذكاء الاصطناعي؟

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

صور المقالات والمدوّنات

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

تصوّرات المنتجات والحملات

أنتج أربع تنويعات لفكرة بصرية واحدة في استدعاء واحد، ليتفق الفريق على اتجاه قبل تكليف الإنتاج الفعلي.

ميزات إبداعية داخل التطبيق

دع مستخدميك يولّدون الصور داخل منتجك دون أن تبني بنية GPU خاصة بك.

المحتوى النائب والنماذج

املأ العروض التقديمية والنماذج الأولية وبيئات البيانات التجريبية بصور معقولة مولَّدة عند الطلب.

07 — التكلفة

كم تكلفة واجهة توليد الصور بالذكاء الاصطناعي؟

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

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

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

08 — ذات صلة

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

واجهة إزالة الخلفيةواجهة تكبير الصورAI Image Generator (أداة الويب)كل نقاط نهاية الواجهة

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

FAQ

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

هي نقطة نهاية HTTP تحوّل وصفًا مكتوبًا إلى صورة. ترسل موجّهك كـ JSON فتعيد الخدمة الصورة المولَّدة في الاستجابة، ما يتيح لمنتجك تقديم توليد الصور من النص دون تشغيل أي بنية نماذج خاصة به.

ابدأ الآن

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

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

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