التوثيق

دليل تكامل GloopAPI

نظرة عامة على التكامل

احصل على مفتاح، واكتشف النماذج، وأرسل طلبك الأول.

يوفر GloopAPI النماذج ومهام التوليد والأدوات وملفات النتائج عبر API موحدة. أنشئ أولًا Key مستقلًا للتطبيق ثم اكتشف الكتالوج المتاح له؛ ظهور نموذج أو أداة على الموقع لا يعني أن مفتاحك مخوّل باستدعائه.

الطلب الأول

أنشئ Key في إعدادات المطوّر بالحساب وضعه في متغير بيئة على الخادم. GLOOP_API_BASE هو أصل API للنشر دون /v1؛ وتستخدم أمثلة الموقع عنوان API المضبوط حاليًا.

export GLOOP_API_BASE="https://api.gloopapi.com"
curl "$GLOOP_API_BASE/v1/models" \
  -H "Authorization: Bearer $GLOOP_API_KEY"

اختر من الكتالوج المُعاد نموذجًا يدعم النص واحفظه باسم GLOOP_MODEL، ثم أرسل طلبًا نصيًا بسيطًا:

curl "$GLOOP_API_BASE/v1/chat/completions" \
  -H "Authorization: Bearer $GLOOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"model\":\"$GLOOP_MODEL\",\"messages\":[{\"role\":\"user\",\"content\":\"你好\"}]}"

توضح الأمثلة كيفية استخدام الواجهة. تعتمد النماذج المتاحة والأسعار على الكتالوج وعروض الأسعار الحالية. قراءة المستندات أو نسخها لا يرسل طلبات.

اختيار مسار العمل

يمكن استهلاك استجابة توليد النص مباشرةً. للصور والفيديوهات الدائمة، اقرأ كتالوج الإمكانات وجهّز المدخلات واطلب عرض سعر وأكّد الإنشاء، ثم احفظ مفتاح الطلب للاستعادة. الصور المتزامنة والصوت يعيدان النتائج مباشرةً، ولا يمكن استخدام واجهات استعادة المهام الدائمة معهما.

ابدأ بقراءة المصادقة واختيار النماذج والتكامل عبر SDK. راجع استجابات البث لقراءة البث، والمهام غير المتزامنة وضمان عدم تكرار التنفيذ لاستعادة المهام.

مداخل API