التوثيق

مرجع API

الحصول على نتائج مهمة الصور

GET/v1/image-tasks/{task_id}/result

متاح فقط عند succeeded/partial_succeeded؛ الأرشفة مستقلة ولا يُضمن التنزيل قبل ready.

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

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

Authorization: Bearer $GLOOP_API_KEY

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

الطلب

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

  • task_idstringمطلوب

    المعرّف العام لمهمة أُنشئت بالمفتاح نفسه.

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

HTTP 200

تم الحصول على نتائج مهمة الصور بنجاح

application/json

النوع
object
الحقول المطلوبة
modelpromptsizenreferencesidstatuscreated_atupdated_atreserved_quotafinal_quotabilling_statusresults
  • 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اختياري

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

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)