مرجع API

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

GET/v1/image-models

يدعم الدليل حاليًا Ark Seedream Pro/Lite وQwen؛ وإصلاحات مساحة عمل Venice الدائمة غير المدمجة خارج هذا الأساس. يعيد مفاتيح الميزات والإمكانات القابلة للتنفيذ بالمفتاح نفسه؛ وليس الدليل ضمانًا للتوفر في الإنتاج.

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

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

Authorization: Bearer $GLOOP_API_KEY

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

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

HTTP 200

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

application/json

النوع: object
الحقول المطلوبة: workspace_enabledfile_storage_enableddataupload_enabled

workspace_enabledbooleanمطلوب
هل تُفعَّل المهام الجديدة في مساحة العمل الحالية؛ لا يعني ذلك حذف الكائنات السابقة.
file_storage_enabledbooleanمطلوب
هل تفعّل الخدمة تخزين الملفات المُدارة.
dataarrayمطلوب
مصفوفة بيانات الصفحة/الدليل الحاليين.
الحقول الفرعية لـ data (1)
- []objectاختياري
  الحقول الفرعية لـ [] (8)
  - idstringمطلوب
    المعرّف العام لهذا الكائن، المستخدم لمسار تفاصيله المقابل.
  - namestringمطلوب
    اسم مقروء للمستخدم.
  - providerstringمطلوب
    اسم مقدّم النموذج المعروض في كتالوج الإمكانات.
  - max_referencesintegerمطلوب
    الحد الأقصى للصور المرجعية التي يسمح بها النموذج المختار.
  - max_nintegerمطلوب
    الحد الأقصى لصور المخرجات التي يسمح بها النموذج المختار.
  - sizesarrayمطلوب
    قائمة الأحجام التي يسمح بها هذا النموذج.
    
    الحقول الفرعية لـ sizes (1)
    []objectاختياري
    الحقول الفرعية لـ [] (2)
    valuestringمطلوب
    قيمة الحجم المُرسلة فعليًا.
    
    labelstringمطلوب
    اسم العرض للحجم.
  - versionstringمطلوب
    إصدار العقد/الإمكانات أو الأداة؛ تستخدم التشغيلات إصدار الأداة الذي يعيده الدليل.
  - outputstringمطلوب
    JSON لمخرجات الأداة أو شكل مخرجات النموذج، وفق المخطط/الإمكانية المقابلين.
upload_enabledbooleanمطلوب
هل تفعّل الخدمة رفع الصور المرجعية.

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اختياري