التوثيق

مرجع API

الاستعلام عن سجل الصور الدائمة

GET/v1/image-tasks

سجل المفتاح نفسه، 20 عنصرًا في الصفحة، باستخدام المؤشر الذي تعيده الخدمة. يظل السجل خاضعًا للتحقق من صلاحيات النموذج الحالية.

المصادقة والصلاحيات

استخدم مفتاح GloopAPI الحالي. تعتمد النماذج والإمكانات والصلاحيات المتاحة على دليله ووثائق نقطة النهاية.

Authorization: Bearer $GLOOP_API_KEY

آليات المصادقة: BearerAuth

الطلب

معاملات الاستعلام

  • cursorstringاختياري

    next_cursor من الاستجابة الأصلية؛ لا تركّبه بنفسك.

  • qstringاختياري

    البحث في التوجيه، بحد أقصى 256 بايت UTF-8.

  • statusstringاختياري

    تصفية دقيقة للحالات queued/dispatching/running/succeeded/partial_succeeded/failed/unknown.

    القيم المعدودة
    ["queued","dispatching","running","succeeded","partial_succeeded","failed","unknown"]

الاستجابات والأخطاء

HTTP 200

تم الاستعلام عن سجل الصور الدائمة بنجاح

application/json

النوع
object
الحقول المطلوبة
datanext_cursor
  • dataarrayمطلوب

    مصفوفة بيانات الصفحة/الدليل الحاليين.

    الحقول الفرعية لـ data (1)
    • []objectاختياري
      الحقول الفرعية لـ [] (17)
      • modelstringمطلوب

        معرّف نموذج عام من دليل المفتاح الحالي.

      • promptstringمطلوب

        توجيه التوليد.

      • sizestringمطلوب

        قيمة الحجم التي يعيدها عنصر image-models المختار؛ تُتحقق الإمكانات والأحجام لكل نموذج.

      • nintegerمطلوب

        عدد صور المخرجات المطلوبة، مع استمرار تطبيق الحد الأقصى للنموذج المختار.

      • referencesarrayمطلوب

        قائمة الصور المرجعية للتوليد.

        الحقول الفرعية لـ 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اختياري

        المعرّف العام لمهمة المصدر، لإثبات المصدر فقط.

      • quote_idstringاختياري

        المعرّف العام لعرض السعر؛ يجب أن يستوفي ارتباط السعر والطلب عند الإنشاء.

      • idstringمطلوب

        المعرّف العام لهذا الكائن، المستخدم لمسار تفاصيله المقابل.

      • statusstringمطلوب

        لا يُعاد unknown تلقائيًا، وقد تبقى الحسابات المحجوزة pending.

        القيم المعدودة
        ["queued","dispatching","running","succeeded","partial_succeeded","failed","unknown","deleted"]
      • created_atintegerمطلوب

        وقت الإنشاء بثواني Unix.

      • updated_atintegerمطلوب

        آخر تحديث بثواني Unix.

      • reserved_quotaintegerمطلوب

        الحصة المحجوزة بوحدات quota للمنصة، وليست مبلغًا بالدولار.

      • final_quotaintegerمطلوب

        التكلفة النهائية بوحدات quota للمنصة؛ تعني null أنها غير محددة.

      • billing_statusstringمطلوب

        حالة الحجز/التسوية/الاسترداد؛ تحقق منها بصورة منفصلة عن حالة المهمة والأرشفة.

      • error_codestringاختياري

        رمز خطأ عام يمكن استخدامه في منطق التفرّع.

      • error_messagestringاختياري

        وصف موجّه للمستخدم بعد معالجته بتصنيف الأخطاء العام.

      • resultsarrayمطلوب

        عناصر المخرجات المولّدة؛ حالة أرشفة كل عنصر مستقلة.

        الحقول الفرعية لـ results (1)
        • []objectاختياري
          الحقول الفرعية لـ [] (7)
          • file_idstringاختياري

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

          • storage_statusstringاختياري

            حالة أرشفة الملف؛ لا تُضمن التنزيلات المُدارة إلا بعد ready.

          • storage_errorstringاختياري

            الفئة العامة لفشل أرشفة الملف.

          • expires_atintegerاختياري

            وقت انتهاء بثواني Unix؛ تعني 0 عدم وجود انتهاء ثابت.

          • urlstringاختياري

            رابط الوصول إلى نتيجة أو مرجع؛ الروابط الموقّعة صالحة لفترة قصيرة فقط.

          • b64_jsonstringاختياري

            سلسلة Base64 للصورة؛ لا تطلبها باعتبارها URL.

          • revised_promptstringاختياري

            التوجيه المعدّل الذي يعيده الخدمة إن وُجد.

  • next_cursorstringمطلوب

    مؤشر الصفحة التالية؛ مرّره كما هو لمعامل التقليب، والفارغ يعني الصفحة الأخيرة.

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)