مرجع API
الحصول على عرض سعر صور دائمة
/v1/image-quotesيتحقق من المدخلات والصلاحيات فقط ولا يقفل الصور. تسري عروض الأسعار لمدة 60 ثانية، ويعيد الإنشاء التحقق من المسار/السعر/الطلب. يؤدي تعطيل مفتاح الخدمة إلى إرجاع 503.
المصادقة والصلاحيات
استخدم مفتاح GloopAPI الحالي. تعتمد النماذج والإمكانات والصلاحيات المتاحة على دليله ووثائق نقطة النهاية.
Authorization: Bearer $GLOOP_API_KEYآليات المصادقة: BearerAuth
الطلب
جسم الطلب · application/json
- النوع
- object
- الحقول المطلوبة
modelpromptsize- خصائص إضافية
- false
جسم الطلب مطلوب
modelstringمطلوبمعرّف نموذج عام من دليل المفتاح الحالي.
- الحد الأقصى للطول
191
promptstringمطلوبغير فارغ، بحد أقصى 32000 بايت UTF-8. يحسب OpenAPI maxLength المحارف، لذلك لا يُحدد حد مصطنع لعدد المحارف.
sizestringمطلوبقيمة الحجم التي يعيدها عنصر image-models المختار؛ تُتحقق الإمكانات والأحجام لكل نموذج.
nintegerاختياريتُطبَّع القيم المحذوفة أو 0 إلى 1. الحد الأقصى الفعلي هو max_n من image-models؛ ولا تعتبر الحد الأقصى العام إمكانية للنموذج.
- القيمة الافتراضية
1- الحد الأدنى
1- الحد الأقصى
6
referencesarrayاختيارياختر واحدًا فقط من file_id أو asset_id أو url لكل عنصر؛ ويحدد max_references العدد الفعلي.
- الحد الأقصى للعناصر
14
الحقول الفرعية لـ references (1)
[]objectاختياريالحقول الفرعية لـ [] (3)
فرع oneOf رقم 1
المطلوب في هذا الفرع: file_id
فرع oneOf رقم 2
المطلوب في هذا الفرع: asset_id
فرع oneOf رقم 3
المطلوب في هذا الفرع: url
source_task_idstringاختياريمهمة مصدر اختيارية تابعة للمفتاح نفسه، لإثبات المصدر فقط؛ ولا تحل محل المراجع.
- الحد الأقصى للطول
64
quote_idstringاختياريعند الإنشاء يجب أن يكون عرضًا صالحًا مطابقًا للطلب؛ يُتجاهل في طلب عرض السعر.
الاستجابات والأخطاء
HTTP 200
تم الحصول على عرض سعر الصور الدائمة بنجاح
application/json
- النوع
- object
- الحقول المطلوبة
pricing_noteidexpires_atreserved_quotaestimated_costcurrency
pricing_notestringمطلوبوصف تسعير النموذج؛ تعتمد التسوية النهائية على القياس المؤكد.
idstringمطلوبالمعرّف العام لهذا الكائن، المستخدم لمسار تفاصيله المقابل.
expires_atintegerمطلوبوقت انتهاء بثواني Unix؛ تعني 0 عدم وجود انتهاء ثابت.
reserved_quotaintegerمطلوبالحصة المحجوزة بوحدات quota للمنصة، وليست مبلغًا بالدولار.
estimated_costnumberمطلوبرسوم البيع المقدرة بعملة عرض السعر.
currencystringمطلوبعملة عرض السعر/الفوترة.
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اختياري