من 3 أرصدة لكل استدعاء
واجهة توليد الصور بالذكاء الاصطناعي
ولّد صورًا من موجّه نصي بطلب JSON واحد. حتى أربع عيّنات لكل استدعاء، وثلاثة نماذج توازن بين السرعة والجودة، وحقوق تجارية كاملة على المخرجات.
- REST · JSON
- بلا علامة مائية
- لا نخزّن شيئًا
POST /v1/generate-image
ما هي واجهة توليد الصور بالذكاء الاصطناعي؟
واجهة توليد الصور من ImgGen AI نقطة نهاية REST تحوّل الموجّهات النصية إلى صور. ترسل جسم JSON يحوي موجّهك وعدد العيّنات المطلوبة ونسبة الأبعاد والنموذج المستخدم، فتعود الصور المولَّدة كمصفوفة مُرمَّزة بـ base64. وهي نقطة النهاية الوحيدة التي تستقبل JSON بدل ملف.
هذه إحدى نقاط النهاية السبع في واجهة تحرير الصور من ImgGen AI، وجميعها تشترك في مفتاح API واحد، وعنوان URL أساسي واحد، وصيغة الطلب والاستجابة نفسها. وإذا احتجت هذه الإمكانية داخل المتصفح لا من الكود، فالنموذج نفسه هو ما يشغّل أداة AI Image Generator.
معاملات الطلب
أرسل طلب POST إلى https://app.imggen.ai/v1/generate-image، مصادَقًا بمفتاح API في ترويسة Authorization.
| المعامل | النوع | مطلوب | الافتراضي | الوصف |
|---|---|---|---|---|
| prompt | string | مطلوب | — | وصف نصي للصورة المراد توليدها. |
| samples | number | اختياري | 1 | عدد الصور المولَّدة، من 1 إلى 4. |
| aspect_ratio | string | اختياري | square | شكل المخرجات. يقبل square أو portrait أو landscape. |
| model | string | اختياري | imggen-base | نموذج التوليد. يقبل imggen-base أو imggen-base-fast أو imggen-xl. |
كيف أدمج واجهة توليد الصور بالذكاء الاصطناعي؟
أنشئ مفتاح 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"
}'import fs from 'node:fs';
const res = await fetch('https://app.imggen.ai/v1/generate-image', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.IMGGEN_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
prompt: 'close up photo of a rabbit in a wildflower meadow',
samples: 1,
aspect_ratio: 'square',
model: 'imggen-base',
}),
});
const data = await res.json();
data.images.forEach((img, i) =>
fs.writeFileSync(`image-${i}.png`, Buffer.from(img, 'base64')),
);import base64, os, requests
res = requests.post(
"https://app.imggen.ai/v1/generate-image",
headers={
"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}",
"Content-Type": "application/json",
},
json={
"prompt": "close up photo of a rabbit in a wildflower meadow",
"samples": 1,
"aspect_ratio": "square",
"model": "imggen-base",
},
)
for i, img in enumerate(res.json()["images"]):
with open(f"image-{i}.png", "wb") as out:
out.write(base64.b64decode(img))الاستجابة
يعيد الاستدعاء الناجح استجابة JSON. والنتيجة مُرمَّزة بـ base64 — فُكّ ترميزها قبل كتابتها على القرص أو في تخزين الكائنات. كما تحمل كل استجابة ناجحة ترويسة X-Credit-Remaining برصيدك بعد الاستدعاء.
{
"success": true,
"message": "Images generated successfully",
"images": ["iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="]
}حدود وسلوكيات يُستحسن معرفتها
تقبل نقطة النهاية صيغ 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.
فيمَ تُستخدم واجهة توليد الصور بالذكاء الاصطناعي؟
حيث تضع الفرق نقطة النهاية هذه في الإنتاج لمعالجة الصور برمجيًا وعلى نطاق واسع.
صور المقالات والمدوّنات
ولّد صورة رأسية فريدة لكل مقال انطلاقًا من عنوانه، بدل السحب من مكتبة صور جاهزة يستخدمها الجميع.
تصوّرات المنتجات والحملات
أنتج أربع تنويعات لفكرة بصرية واحدة في استدعاء واحد، ليتفق الفريق على اتجاه قبل تكليف الإنتاج الفعلي.
ميزات إبداعية داخل التطبيق
دع مستخدميك يولّدون الصور داخل منتجك دون أن تبني بنية GPU خاصة بك.
المحتوى النائب والنماذج
املأ العروض التقديمية والنماذج الأولية وبيئات البيانات التجريبية بصور معقولة مولَّدة عند الطلب.
كم تكلفة واجهة توليد الصور بالذكاء الاصطناعي؟
يكلّف كل استدعاء ناجح من 3 أرصدة، وبذلك تتبع تكلفتك الفعلية لكل صورة الخطة التي تشترك بها. تأتي الأرصدة من خطتك وهي مشتركة بين كل نقاط النهاية ومحرّر الويب، فلا تشتري حصة منفصلة لكل أداة. ويُرد الاستدعاء الفاشل تلقائيًا. اطّلع على كل التفاصيل في صفحة الأسعار.
| الخطة | السعر | الأرصدة | API |
|---|---|---|---|
| Free | $0 | 50 رصيدًا مجانيًا لمرة واحدة | بلا وصول إلى الواجهة |
| Starter | $9.99 / month | 400 رصيد / شهر | الوصول إلى الواجهة مشمول |
| Pro | $29.99 / month | 1,400 رصيد / شهر | وصول إلى الواجهة + دعم ذو أولوية |
| Enterprise | Custom | حجم مخصص | بنية تحتية مخصصة |
آخر تحقق من تكاليف الأرصدة والحدود 2026-08-27.
نقاط نهاية وأدوات ذات صلة
الفرق التي تستخدم واجهة توليد الصور عادةً ما تلجأ إلى هذه بعدها.
متاح أيضًا: إزالة العلامة المائية, إزالة النص, ترميم الصور, تلوين الصور.
أسئلة شائعة عن واجهة توليد الصور
- هي نقطة نهاية HTTP تحوّل وصفًا مكتوبًا إلى صورة. ترسل موجّهك كـ JSON فتعيد الخدمة الصورة المولَّدة في الاستجابة، ما يتيح لمنتجك تقديم توليد الصور من النص دون تشغيل أي بنية نماذج خاصة به.
- من صورة واحدة إلى أربع، عبر المعامل samples. وتعود كل الصور المطلوبة في مصفوفة images واحدة ضمن الاستجابة نفسها.
- ثلاثة: imggen-base وهو الافتراضي ويوازن بين الجودة والسرعة، وimggen-base-fast الذي يعيد النتائج أسرع مقابل تفاصيل أقل، وimggen-xl الذي يستهدف أعلى جودة. تختار بينها لكل طلب عبر المعامل model.
- square وportrait وlandscape عبر aspect_ratio. والقيمة الافتراضية هي square إن لم تحدد شيئًا.
- التوليد يُحتسب حسب النموذج لا برسم ثابت، لأن النماذج تتفاوت كثيرًا في كلفة الحوسبة. يبدأ النموذج الأساسي من 3 أرصدة للصورة، وترتفع التكلفة مع النماذج الأعلى جودة. ويعود رصيدك المتبقي في ترويسة X-Credit-Remaining مع كل استدعاء ناجح، وتجد التكلفة الحالية لكل نموذج في حسابك على ImgGen.
- لك. لا تدّعي ImgGen ملكية أي شيء تعيده الواجهة، وكل الخطط تشمل حقوق استخدام تجاري كاملة دون علامة مائية. غير أن حقوق النشر للصور المولَّدة بالذكاء الاصطناعي تُعامَل بشكل مختلف بين ولاية قضائية وأخرى، لذا تحقق من القواعد المحلية إن كانت الملكية مسألة قانونية جوهرية في استخدامك.
- نعم. كل الخطط، بما فيها المجانية، تشمل حقوق استخدام تجاري كاملة، ولا تحمل أي مخرجات علامة مائية. يمكنك بيع أي شيء تُعيده الواجهة أو طباعته أو نشره.
- تُعاد الصور المولَّدة في الاستجابة ولا تُحفظ. وكما هو الحال في كل نقاط نهاية ImgGen، الشيء الوحيد الذي يبقى هو سجل استخدام يوثّق أن استدعاءً قد حدث وكم كلّف. ولا يُستخدم محتواك في تدريب النماذج.
ابدأ الآن
ابدأ استدعاء واجهة توليد الصور
مفتاح واحد يفتح نقاط النهاية السبع جميعها. بلا علامة مائية، مع حقوق تجارية كاملة، ولا يُحفظ أي شيء ترسله بعد إرجاع الاستجابة.
احصل على مفتاح API