ShareAI Platform Docs

إنشاء صورة

أنشئ صورًا باستخدام ShareAI Images API باستخدام نموذج مدعوم، مطالبة نصية وخيارات إنشاء صور مُعتمدة.

عرض كـ Markdown
في هذه الصفحة
POST https://api.shareai.now/api/v1/images/generations

إنشاء صورة من مطالبة نصية.

عنوان URL الأساسي
https://api.shareai.now
المصادقة
مفتاح واجهة برمجة التطبيقات Bearer أو رمز وصول OAuth المعتمد

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

إرسال طلب#

cURL

curl --fail-with-body --request POST \
  "https://api.shareai.now/api/v1/images/generations" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_IMAGE_MODEL",
  "prompt": "A quiet forest painted in watercolor.",
  "n": 1,
  "size": "1024x1024"
}'

حقول الطلب#

الحقلالقيمة
modelمعرف نموذج إنشاء الصور المفعّل.
promptوصف نصي غير فارغ.
nعدد الصور، من 1 إلى 10، وفقًا لدعم النموذج.
size / qualityقيم الحجم والجودة المدعومة اختياريًا بواسطة النموذج.
response_format / output_formatإعدادات الرد وصيغة الملف المدعومة اختياريًا بواسطة النموذج.
backgroundإعداد الخلفية المدعوم اختياريًا بواسطة النموذج.

قراءة الصورة#

تفقد data الإدخالات المُرجعة. بناءً على النموذج والصيغة المطلوبة، يحتوي الإدخال على رابط صورة HTTPS أو بيانات صورة base64. استخدم الصيغة المُرجعة الفعلية؛ لا تفترض أن كل مزود يُرجع رابطًا. لا يقوم API بتنزيل روابط الصور المُرجعة نيابةً عنك.

حدود الحجم والتوقيت#

الطلبات متزامنة. النص المُجمع محدود بـ 256 KiB، الاتصال بالمزود بـ 120 ثانية والرد بـ 2 MiB. يمكن أن تتجاوز الصور الكبيرة بصيغة base64 هذا الحد. اختر حجم إخراج مناسبًا أو نموذجًا يدعم إخراج الروابط.

إعادة المحاولة بحذر#

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

العمليات المدعومة#

يقوم هذا المسار بإنشاء صور من النص. تحرير الصور، التعديلات، التحميلات المتعددة وأحداث إنشاء الصور المتدفقة غير مدعومة. يتطلب الفوترة الحالية عقد استخدام الرموز المتوافقة مع النموذج/المزود؛ قد تكون المزودات التي تعتمد فقط على الصور غير متاحة.

استخدام تفويض العميل#

للحصول على تدفق OAuth معتمد، أرسل رمز الوصول كـ Bearer. يتطلب إنشاء الصور الممول من الحساب surcharge وخطة استخدام مقبولة. تظل جميع قيود النموذج، المزود والحساب سارية.

آخر تحديث سبتمبر 15, 2026

مستندات منصة ShareAI
جميع المستندات

البحث حسب العنوان أو المحتوى.

اسأل عن هذه الصفحة

اختر مساعدًا لاستكشاف هذه الصفحة. يمكنك أيضًا نسخ الصفحة ولصقها في محادثتك.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI