دليل تكامل GloopAPI
اختيار النموذج
اكتشف النماذج المتاحة للمفتاح الحالي.
يجب أن يأتي معرّف النموذج من الكتالوج المتاح لـ Key الخاص بك. عرض النماذج العام مخصص للتصفح، ولا يمنح صلاحية التنفيذ ولا يضمن إمكانات الواجهة أو الأسعار أو التفعيل في الإنتاج.
النص والبروتوكولات
اقرأ أولاً كتالوج النماذج المتاح لمفتاحك. تستخدم القوائم والتفاصيل تنسيق OpenAI. استدعِ نماذج المحادثة عبر Chat Completions أو Responses وتحقق من القدرات المطلوبة قبل إرسال الطلب.
تتطلب الصور المدخلة نموذجاً يدعم الرؤية. يعتمد الإخراج المنظم واستدعاء الأدوات على النموذج المختار؛ وجود معرّف في الكتالوج لا يضمن دعم كل الحقول الاختيارية.
إمكانات الصور والفيديو
يجب أن تقرأ المسارات الدائمة كتالوج الإمكانات المخصص وتتحقق من مفاتيح التفعيل وأوضاع الإدخال والأبعاد والإعدادات المسبقة الكاملة قبل التسعير. تشمل القاعدة الحالية للصور الدائمة Ark Seedream Pro/Lite وQwen. يولّد Venice المتزامن صورة واحدة من النص ولا يدعم الصور المرجعية؛ ولا تمثل الإمكانات المتزامنة تعهدًا من الكتالوج الدائم.
يعيد كتالوج الفيديو preset كاملًا قابلًا للتنفيذ. استخدمه كمجموعة واحدة، ولا تجمع الدقة والمدة والصوت ونسبة العرض من أوضاع مختلفة. يجب أن تكون مدخلات الإطارات ملفات مستضافة يسمح بها النموذج. وقد لا تظهر أوضاع الصور المعنية إذا لم تكن مدخلات HTTPS العامة الموقعة جاهزة.
الإصدارات وسجلات التشغيل
تمثل الأسماء البديلة الهوية العامة للنموذج، ولا ترث تلقائيًا أذونات نموذج الخدمة. تستخدم المهام الجديدة التوجيه والأسعار السارية حينها، بينما تحفظ المهام المقبولة أدلة التنفيذ والفوترة. إذا تغيّر الكتالوج أو السعر بعد العرض فأعد التأكيد؛ واستعد المهام القائمة باستخدام مفتاح الطلب والهوية الأصليين.
إذا كان كتالوج الإمكانات فارغًا فتحقق أولًا من الأذونات ومفاتيح التفعيل، ولا تستكشف التوفر عبر استدعاءات توليد متكررة. راجع حدود الأخطاء والتكاليف في معالجة الأخطاء والفوترة.