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