مرجع API
توليد صور بشكل متزامن
/v1/images/generationsتتحقق الطلبات المتزامنة من المعاملات بحسب النموذج؛ ولا تتاح إلا إمكانات الصور التي تدعمها القنوات المتزامنة. يدعم Qwen حتى 6 صور/3 صور مرجعية؛ وتختلف حدود Ark بحسب النموذج. ينتج تحويل النص إلى صورة في Venice صورة واحدة ولا يدعم الصور المرجعية. تتبع ملفات API العادية سياسة تخزين بالأيام، وليست مكافئة لمهام الصور الدائمة.
حدود المخرجات المتزامنة
يدعم Qwen حتى 6 صور ناتجة و3 صور مرجعية. تختلف حدود Ark حسب النموذج، بينما يوفر Venice صورة واحدة من النص فقط. اختر النموذج أولًا ثم أرسل الحقول المناسبة، ولا ترسل صورًا مرجعية إلى قناة لا تدعمها.
عند الحاجة إلى تأكيد عرض سعر وسجل طويل الأجل واستعادة بعد انقطاع الاتصال، استخدم مسار الصور الدائمة بدل تكرار طلب التوليد المتزامن تلقائيًا. ترويسات أرشفة الملفات في الرد المتزامن تصف مرحلة الحفظ فقط. يختلف الاحتفاظ العادي بالملفات عن حماية مراجع المهام؛ راجع الفوترة.
المصادقة والصلاحيات
استخدم مفتاح GloopAPI الحالي. تعتمد النماذج والإمكانات والصلاحيات المتاحة على دليله ووثائق نقطة النهاية.
Authorization: Bearer $GLOOP_API_KEYآليات المصادقة: BearerAuth
الطلب
جسم الطلب · application/json
- النوع
- object
- الحقول المطلوبة
modelprompt
جسم الطلب مطلوب
image_urlsarrayاختياريقائمة روابط الصور المرجعية الخاصة بالنموذج. لكل من Qwen/Ark حدوده؛ ويرفض تحويل النص إلى صورة المتزامن في Venice هذا الحقل.
الحقول الفرعية لـ image_urls (1)
[]stringاختياري
modelstringمطلوبمعرّف نموذج عام من دليل المفتاح الحالي.
promptstringمطلوبتوجيه التوليد.
nintegerاختياريعدد صور المخرجات المطلوبة، مع استمرار تطبيق الحد الأقصى للنموذج المختار.
sizestringاختياريقيمة الحجم التي يعيدها عنصر image-models المختار؛ تُتحقق الإمكانات والأحجام لكل نموذج.
response_formatstringاختياريتنسيق مخرجات خاص بالنموذج؛ لا تفترض أن كل نموذج يدعم كل تنسيق.
userunknownاختياريقيمة JSON يحددها مخطط الأداة المختارة أو البروتوكول؛ لا تفترض حقولًا ثابتة.
extra_bodyunknownاختياريقيمة JSON يحددها مخطط الأداة المختارة أو البروتوكول؛ لا تفترض حقولًا ثابتة.
الاستجابات والأخطاء
HTTP 200
تم توليد الصور بشكل متزامن بنجاح
application/json
- النوع
- object
- الحقول المطلوبة
createddata
createdintegerمطلوبوقت توليد استجابة الصورة بثواني Unix.
dataarrayمطلوبمصفوفة بيانات الصفحة/الدليل الحاليين.
الحقول الفرعية لـ data (1)
[]objectاختياريالحقول الفرعية لـ [] (7)
file_idstringاختياريالمعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.
storage_statusstringاختياريحالة أرشفة الملف؛ لا تُضمن التنزيلات المُدارة إلا بعد ready.
storage_errorstringاختياريالفئة العامة لفشل أرشفة الملف.
expires_atintegerاختياريوقت انتهاء بثواني Unix؛ تعني 0 عدم وجود انتهاء ثابت.
urlstringاختياريرابط الوصول إلى نتيجة أو مرجع؛ الروابط الموقّعة صالحة لفترة قصيرة فقط.
b64_jsonstringاختياريسلسلة Base64 للصورة؛ لا تطلبها باعتبارها URL.
revised_promptstringاختياريالتوجيه المعدّل الذي يعيده الخدمة إن وُجد.
HTTP 400
حقول الطلب أو معاملاته غير صالحة.
application/json
- النوع
- object
- الحقول المطلوبة
error
errorobjectمطلوبالحقول الفرعية لـ error (4)
codestringاختياريmessagestringاختياريtypestringاختياريrequest_idstringاختياري
HTTP 401
Key مفقود أو غير صالح أو منتهي أو ملغى.
application/json
- النوع
- object
- الحقول المطلوبة
error
errorobjectمطلوبالحقول الفرعية لـ error (4)
codestringاختياريmessagestringاختياريtypestringاختياريrequest_idstringاختياري
HTTP 403
صلاحيات IP أو الحساب أو النموذج أو الأداة غير كافية.
application/json
- النوع
- object
- الحقول المطلوبة
error
errorobjectمطلوبالحقول الفرعية لـ error (4)
codestringاختياريmessagestringاختياريtypestringاختياريrequest_idstringاختياري
HTTP 404
الكائن/الإمكانية غير متاحين، أو مفتاح الميزة معطّل.
application/json
- النوع
- object
- الحقول المطلوبة
error
errorobjectمطلوبالحقول الفرعية لـ error (4)
codestringاختياريmessagestringاختياريtypestringاختياريrequest_idstringاختياري
HTTP 409
تعارض في منع التكرار/عرض السعر، أو كائن غير جاهز، أو ما يزال مشارًا إليه.
application/json
- النوع
- object
- الحقول المطلوبة
error
errorobjectمطلوبالحقول الفرعية لـ error (4)
codestringاختياريmessagestringاختياريtypestringاختياريrequest_idstringاختياري
HTTP 429
حد معدل الطلبات/قائمة الانتظار.
application/json
- النوع
- object
- الحقول المطلوبة
error
errorobjectمطلوبالحقول الفرعية لـ error (4)
codestringاختياريmessagestringاختياريtypestringاختياريrequest_idstringاختياري
HTTP 500
فشل داخلي في المصادقة أو تخزين البيانات.
application/json
- النوع
- object
- الحقول المطلوبة
error
errorobjectمطلوبالحقول الفرعية لـ error (4)
codestringاختياريmessagestringاختياريtypestringاختياريrequest_idstringاختياري
HTTP 503
الخدمة أو التسعير أو التخزين غير متاح.
application/json
- النوع
- object
- الحقول المطلوبة
error
errorobjectمطلوبالحقول الفرعية لـ error (4)
codestringاختياريmessagestringاختياريtypestringاختياريrequest_idstringاختياري