مرجع API

الحصول على عرض سعر صور دائمة

POST/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)
      • file_idstringاختياري

        المعرّف العام لملف مُدار للحساب والمفتاح نفسيهما.

      • asset_idstringاختياري

        معرّف أصل مرفوع للحساب والمفتاح نفسيهما.

      • urlstringاختياري

        رابط HTTPS عام دون userinfo أو fragment؛ يخضع لفحص SSRF.

        التنسيق
        "uri"
      فرع 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)

HTTP 401

Key مفقود أو غير صالح أو منتهي أو ملغى.

application/json

النوع
object
الحقول المطلوبة
error
  • errorobjectمطلوب
    الحقول الفرعية لـ error (4)

HTTP 403

صلاحيات IP أو الحساب أو النموذج أو الأداة غير كافية.

application/json

النوع
object
الحقول المطلوبة
error
  • errorobjectمطلوب
    الحقول الفرعية لـ error (4)

HTTP 404

الكائن/الإمكانية غير متاحين، أو مفتاح الميزة معطّل.

application/json

النوع
object
الحقول المطلوبة
error
  • errorobjectمطلوب
    الحقول الفرعية لـ error (4)

HTTP 409

تعارض في منع التكرار/عرض السعر، أو كائن غير جاهز، أو ما يزال مشارًا إليه.

application/json

النوع
object
الحقول المطلوبة
error
  • errorobjectمطلوب
    الحقول الفرعية لـ error (4)

HTTP 429

حد معدل الطلبات/قائمة الانتظار.

application/json

النوع
object
الحقول المطلوبة
error
  • errorobjectمطلوب
    الحقول الفرعية لـ error (4)

HTTP 500

فشل داخلي في المصادقة أو تخزين البيانات.

application/json

النوع
object
الحقول المطلوبة
error
  • errorobjectمطلوب
    الحقول الفرعية لـ error (4)

HTTP 503

الخدمة أو التسعير أو التخزين غير متاح.

application/json

النوع
object
الحقول المطلوبة
error
  • errorobjectمطلوب
    الحقول الفرعية لـ error (4)