إنشاء صورة
أنشئ صورًا باستخدام ShareAI Images API باستخدام نموذج مدعوم، مطالبة نصية وخيارات إنشاء صور مُعتمدة.
في هذه الصفحة
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"
}'
Python
import json
import os
import urllib.request
headers = {"Authorization": "Bearer " + os.environ["SHAREAI_API_KEY"]}
headers["Content-Type"] = "application/json"
payload = {'model': 'YOUR_IMAGE_MODEL', 'prompt': 'A quiet forest painted in watercolor.', 'n': 1, 'size': '1024x1024'}
data = json.dumps(payload).encode()
request = urllib.request.Request('https://api.shareai.now/api/v1/images/generations', data=data, headers=headers, method='POST')
with urllib.request.urlopen(request, timeout=180) as response:
print(json.load(response))
TypeScript
const url = "https://api.shareai.now/api/v1/images/generations";
const headers: Record = {
Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
"model": "YOUR_IMAGE_MODEL",
"prompt": "A quiet forest painted in watercolor.",
"n": 1,
"size": "1024x1024"
};
const response = await fetch(url, { method: "POST", headers, body: JSON.stringify(payload) });
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());
حقول الطلب#
| الحقل | القيمة |
|---|---|
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