ShareAI Platform Docs

إنشاء الصور

يحتوي الرد المتزامن لـ JSON على نتائج الصور في البيانات.

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

إنشاء الصور

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

يحتوي الرد المتزامن لـ JSON على نتائج الصور في data. الاسم المستعار /api/v1/images/generations مدعوم أيضًا. تعتمد الخيارات مثل الحجم، الدقة، نسبة العرض إلى الارتفاع، الجودة، وصيغة الإخراج على النموذج المختار. الردود محدودة بـ 2 MiB؛ قم بتقليل عدد الصور أو حجمها عند الحاجة. الصور المُرجعة محدودة بـ 8192 بكسل لكل جانب.

قبل أن تبدأ#

المعنى والحدود.

إرسال طلب#

cURL

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

حقول الطلب#

الحقلالنوعمطلوب
model سلسلة نصيةمعرف النموذج العام المفعل بالضبط. يجب أن يعلن عن هذه العملية وأن يكون مسموحًا بها بواسطة بيانات الاعتماد الخاصة بك.استعلام ذو صلة غير فارغ.
prompt سلسلة نصيةمعرف النموذج العام المفعل بالضبط. يجب أن يعلن عن هذه العملية وأن يكون مسموحًا بها بواسطة بيانات الاعتماد الخاصة بك.مطالبة توليد غير فارغة، بحد أقصى 256 KiB من نص UTF-8.
nعدد النتائج الاختياري من 1 إلى عدد المستندات. تشير المؤشرات المرجعة إلى مصفوفة المستندات الأصلية.عدد الصور الاختياري، من 1 إلى 10؛ الافتراضي هو 1. قد يسمح النموذج بعدد أقل.
sizeمعرف النموذج العام المفعل بالضبط. يجب أن يعلن عن هذه العملية وأن يكون مسموحًا بها بواسطة بيانات الاعتماد الخاصة بك.حجم الإخراج المدعوم من النموذج، بحد أقصى 100 حرف، على سبيل المثال 1024×1024. ليس كل نموذج يدعم هذا الخيار.
resolutionمعرف النموذج العام المفعل بالضبط. يجب أن يعلن عن هذه العملية وأن يكون مسموحًا بها بواسطة بيانات الاعتماد الخاصة بك.محدد الدقة المدعوم من النموذج، بحد أقصى 100 حرف؛ يجب أن يتطابق مع نوع التعرفة المنشورة.
aspect_ratioمعرف النموذج العام المفعل بالضبط. يجب أن يعلن عن هذه العملية وأن يكون مسموحًا بها بواسطة بيانات الاعتماد الخاصة بك.محدد نسبة العرض إلى الارتفاع المدعوم من النموذج، بحد أقصى 100 حرف.
qualityمعرف النموذج العام المفعل بالضبط. يجب أن يعلن عن هذه العملية وأن يكون مسموحًا بها بواسطة بيانات الاعتماد الخاصة بك.محدد الجودة المدعوم من النموذج، بحد أقصى 100 حرف؛ قد يختار معدلًا مختلفًا.
response_formatمعرف النموذج العام المفعل بالضبط. يجب أن يعلن عن هذه العملية وأن يكون مسموحًا بها بواسطة بيانات الاعتماد الخاصة بك.صيغة الرد المدعومة من النموذج، بحد أقصى 100 حرف. تحدد العملية ما إذا كانت النتيجة JSON أو ثنائية.
output_formatمعرف النموذج العام المفعل بالضبط. يجب أن يعلن عن هذه العملية وأن يكون مسموحًا بها بواسطة بيانات الاعتماد الخاصة بك.محدد ترميز الإخراج المدعوم من النموذج، بحد أقصى 100 حرف.
backgroundمعرف النموذج العام المفعل بالضبط. يجب أن يعلن عن هذه العملية وأن يكون مسموحًا بها بواسطة بيانات الاعتماد الخاصة بك.إعداد خلفية الصورة الاختياري عند دعم النموذج.
seedعدد النتائج الاختياري من 1 إلى عدد المستندات. تشير المؤشرات المرجعة إلى مصفوفة المستندات الأصلية.البذرة المدعومة اختياريًا من النموذج. الفيديو يتطلب عددًا صحيحًا غير سالب؛ تعتمد القابلية للتكرار على المنفذ.
input_referencesمصفوفةبحد أقصى 16 جزءًا من image_url مع تعيين image_url.url إلى رابط HTTPS أو رابط بيانات صورة مدعوم. يتطلب دعم النموذج.
providerتفضيلات توجيه المزود الاختيارية. استخدم provider.only للعلامات المقبولة للمزود، وليس بادئة في معرف النموذج. لا تزال قيود الحساب والبيانات الاعتمادية سارية.النجاح يعيد HTTP 200 مع JSON. قدم استعلامًا و1–1000 مستند. كل مستند هو نص،.

قراءة النتيجة#

النجاح يعيد HTTP 200 مع JSON. يحتوي الرد المتزامن لـ JSON على نتائج الصور في data. الاسم المستعار /api/v1/images/generations مدعوم أيضًا. تعتمد الخيارات مثل الحجم، الدقة، نسبة العرض إلى الارتفاع، الجودة، وصيغة الإخراج على النموذج المختار. الردود محدودة بـ 2 MiB؛ قم بتقليل عدد الصور أو حجمها عند الحاجة. الصور المُرجعة محدودة بـ 8192 بكسل لكل جانب.

وحدات الفوترة#

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

يتم نشر الأسعار بعملة EUR AI credits للنموذج المحدد، المزود، الوحدات والمتغيرات. يتم فرض الرسوم فقط على الأبعاد في التعريفة النشطة. يحتفظ التقدير بالاعتمادات قبل التنفيذ؛ تستخدم الرسوم النهائية الاستخدام المقاس. يمكن أن تعتمد الأسعار على الدقة، تنسيق الإخراج أو نطاق الاستخدام. تحقق من Console Usage للحصول على الخصم النهائي من ShareAI. لا يتم تحويل حقول التكلفة الأولية والوسائط إلى عدد رموز مُخترع.

التسعير والاستخدام#

لتوجيه تكلفة الشبكة المعتمدة أو.

الوصول والأخطاء#

استخدم inference لزيادة معتمدة من Builder وشروط الفوترة المقبولة. الوصول بالهوية فقط لا يصرح بالإنفاق. التحقق، تفويض النموذج، الاعتمادات غير الكافية، حدود المعدل وفشل التنفيذ تعيد هيكلًا monetization_gateway . بعد انتهاء المهلة أو تقديم غير مؤكد، تحقق من الاستخدام أو مهمة الفيديو قبل إنشاء طلب آخر قد يكون مدفوعًا. error. آخر تحديث نوفمبر 3, 2026.

رابط إلى وحدات الفوترة

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

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

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

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

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI