دليل ترحيل واجهة برمجة التطبيقات (API) لـ Pangram 3.0

تم إطلاق واجهة برمجة التطبيقات (API) 3.0 من Pangram! يغطي هذا الدليل كل ما تحتاج إلى معرفته حول الانتقال من نقاط النهاية v2 إلى واجهة برمجة التطبيقات (API) v3 الجديدة.

ما الجديد في الإصدار 3؟

لقد أدخلنا فئة تصنيف ثالثة للنصوص المدعومة بالذكاء الاصطناعي. وعادةً ما تُكتب النصوص التي تندرج ضمن هذه الفئة بمساهمة كبيرة من الذكاء الاصطناعي والعامل البشري — مما يعكس الطريقة التي يستخدم بها الناس أدوات الذكاء الاصطناعي في الواقع اليوم.

التغييرات الرئيسية في المخطط

تصنف واجهة برمجة التطبيقات (API) v3 كل مستند باستخدام ثلاثة حقول كسورية تشير إلى النسبة المئوية من المستند التي تندرج تحت كل فئة:

• الجزء_البشري — الجزء المصنف على أنه مكتوب بخط اليد
• fraction_ai_assisted — الجزء المصنف على أنه مدعوم بالذكاء الاصطناعي
• fraction_ai — الجزء المصنف على أنه من إنتاج الذكاء الاصطناعي

هذه المجالات الثلاثة متنافية فيما بينها وتشمل كل شيء؛ ومجموعها يساوي دائمًا 1.

بالإضافة إلى ذلك، تتضمن كل وثيقة ثلاث سلاسل تنبؤية بمستويات تفصيل مختلفة:

• العنوان — على سبيل المثال، "كتبه الإنسان بالكامل"، "بمساعدة الذكاء الاصطناعي"، "تم اكتشافه بواسطة الذكاء الاصطناعي"
• التنبؤ — شرح مفصل للتصنيف. على سبيل المثال، "نحن على ثقة من أن هذه الوثيقة تم إنشاؤها بالكامل بواسطة الذكاء الاصطناعي" أو "نعتقد أن هذه الوثيقة تم إنشاؤها بمساعدة الذكاء الاصطناعي، ولكن لم يتم إنشاؤها بالكامل بواسطة الذكاء الاصطناعي".
• توقعات_موجزة — على سبيل المثال، "بشري"، "مختلط"، "ذكاء اصطناعي"

التحليل على مستوى النافذة

يتم تقسيم كل مستند مدخل إلى نوافذ. وتحتوي كل نافذة على:

• تسمية — سلسلة التصنيف («بصنع الإنسان»، «بمساعدة الذكاء الاصطناعي بشكل معتدل»، «من إنتاج الذكاء الاصطناعي»، إلخ)
• الثقة — درجة الثقة الناتجة عن نموذج الكشف الخاص بـ Pangram («عالية»، «متوسطة»، «منخفضة»)
• ai_assistance_score — قيمة عددية تتراوح بين 0 و1 تشير إلى مدى المساعدة التي تقدمها الذكاء الاصطناعي

ملاحظة: من المتوقع أن يتم إدخال تصنيفات إضافية ("بمساعدة طفيفة من الذكاء الاصطناعي"، "بمساعدة كبيرة من الذكاء الاصطناعي") في المستقبل القريب.

---

هل يجب أن أنتقل؟

نعم ، إذا كنت:

• استخدام نتائج Pangram في بيئة الإنتاج
• هل ترغب في تحسين دقة النتائج الصادرة عن أحدث نماذج الذكاء الاصطناعي؟
• خطط لاستخدام واجهة برمجة تطبيقات Pangram بعد 1 أبريل 2026

لا ، إذا كنت:

• هل أنت باحث وتحتاج إلى واجهة برمجة تطبيقات ثابتة لضمان قابلية التكرار؟

---

الجدول الزمني

---

نقاط النهاية V2 (متاحة حتى 1 أبريل 2026)

ستظل نقاط النهاية التالية من الإصدار 2 متاحة خلال الفترة الانتقالية:

• text.api.pangram.com
• text-batch.api.pangram.com
• text-sliding.api.pangram.com
• text-extended.api.pangram.com
• dashboard-text.api.pangram.com

---

دليل الهجرة الميداني

من text.api.pangram.com

نقطة النهاية: https://text.api.pangram.com → https://text.api.pangram.com/v3

للحصول على فهم شامل لتنبؤات بانغرام، استخدم الحقول ذات المستوى الأعلى:

مطابقة سلوك نقطة النهاية الأصلية: كانت نقطة النهاية الأصلية تستخدم فقط السطر الأول من النص لإجراء التنبؤ. لمطابقة هذا السلوك:

هام: تفسير ai_assistance_score يختلف عن احتمالية ai. هذه الحقول ليست ذات علاقة أحادية. توقع المزيد من التوقعات في النطاق المتوسط (0–1). استخدم تسمية لفهم التفسير الذي نوصي به.

---

من text-batch.api.pangram.com

لا توجد حاليًا نقطة نهاية معالجة مجمعة لواجهة برمجة التطبيقات (API) الإصدار 3. استخدم حلقة لمعالجة كل عنصر على حدة، باتباع text.api.pangram.com دليل الترحيل أعلاه.

---

من text-sliding.api.pangram.com

نقطة النهاية: https://text-sliding.api.pangram.com → https://text.api.pangram.com/v3

تغييرات في النافذة:

• في تحريك النص، النوافذ هي متداخلة
• في الإصدار 3، لا تتداخل النوافذ

---

من text-extended.api.pangram.com

نقطة النهاية: https://text-extended.api.pangram.com → https://text.api.pangram.com/v3

تظل معظم الحقول دون تغيير:

الحقول التي تم تغييرها:

---

الوثائق

تتوفر الوثائق الكاملة لواجهة برمجة التطبيقات (API) هنا.

---

هل لديك أي أسئلة؟

إذا كانت لديك أي أسئلة بشأن الترحيل إلى الإصدار 3، يرجى التواصل معنا عبر البريد الإلكتروني support@pangram.com.