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

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

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

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

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

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

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

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

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

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

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

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

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

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

---

هل يجب أن أهاجر؟

نعم إذا كنت:

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

لا ، إذا كنت:

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

---

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

التاريخ	حدث
11 ديسمبر 2025	إصدار Pangram 3.0 من خلال لوحة التحكم
23 ديسمبر 2025	Pangram 3.0 متاح عبر واجهة برمجة التطبيقات
أواخر يناير 2026	تم إصدار Pangram 3.1 (لوحة التحكم + واجهة برمجة التطبيقات). تم ترقية جميع مستخدمي واجهة برمجة التطبيقات 3.0 تلقائيًا.
1 أبريل 2026	توقف API Pangram 2.0

---

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

تظل نقاط النهاية v2 التالية متاحة خلال الفترة الانتقالية:

• 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

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

v2 الحقل	v3 الحقل	ملاحظات
تنبؤ	العنوان الرئيسي	قيم مثل "مكتوب بالكامل بواسطة الإنسان" و"بمساعدة الذكاء الاصطناعي" و"اكتشفه الذكاء الاصطناعي"
ai_likelihood	fraction_ai	كمية النص الذي يُعتقد أنه تم إنشاؤه بواسطة الذكاء الاصطناعي
—	fraction_ai_assisted	جديد: الكمية التي يُعتقد أنها مدعومة بالذكاء الاصطناعي
—	جزء_بشري	الكمية التي يعتقد أنها مكتوبة بخط اليد

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

v2 الحقل	v3 الحقل
تنبؤ	windows[0].label و windows[0].الثقة
ai_likelihood	windows[0].ai_assistance_score

هام: تفسير ai_assistance_score يختلف عن ai_likelihood. هذه الحقول ليست واحد إلى واحد. توقع المزيد من التوقعات في النطاق المتوسط (0-1). استخدم ملصق لفهم تفسيرنا الموصى به.

---

من text-batch.api.pangram.com

لا توجد حاليًا نقطة نهاية دفعية لواجهة برمجة التطبيقات v3. استخدم حلقة لتجهيز كل عنصر على حدة، باتباع text.api.pangram.com دليل الهجرة أعلاه.

---

من text-sliding.api.pangram.com

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

v2 الحقل	v3 الحقل	ملاحظات
تنبؤ	العنوان الرئيسي أو تنبؤ	تتوفر مستويات مختلفة من التفصيل
تنبؤ_قصير	تنبؤ_قصير	دون تغيير
ai_likelihood, avg_ai_likelihood	fraction_ai, fraction_ai_assisted, جزء_بشري	استخدم حقول الكمية بدلاً من درجات الثقة المجمعة
max_ai_likelihood	fraction_ai (موصى به)	حقول الكمية المفضلة

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

• في نص منزلق، النوافذ هي تداخل
• في الإصدار 3، النوافذ غير متداخلة

v2 حقل النافذة	v3 حقل النافذة
windows[].التنبؤ	windows[].label + windows[].confidence
windows[].ai_likelihood	windows[].ai_assistance_score

---

من text-extended.api.pangram.com

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

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

الميدان	الحالة
العنوان الرئيسي	دون تغيير
تنبؤ	دون تغيير
تنبؤ_قصير	دون تغيير
جزء_بشري	دون تغيير
fraction_ai	دون تغيير
windows[].label	دون تغيير
windows[].confidence	دون تغيير
windows[].start_index	دون تغيير
windows[].end_index	دون تغيير

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

v2 الحقل	v3 الحقل	ملاحظات
fraction_mixed	fraction_ai_assisted	تم تغيير اسم الحقل من أجل الوضوح
لوحة القيادة	رابط لوحة التحكم العامة	تم تغيير اسم الحقل من أجل الوضوح
avg_ai_likelihood	fraction_ai, fraction_ai_assisted, جزء_بشري	استخدم حقول الكمية بدلاً من درجات الثقة المجمعة
max_ai_likelihood	fraction_ai, fraction_ai_assisted, جزء_بشري	استخدم حقول الكمية بدلاً من درجات الثقة المجمعة
windows[].ai_likelihood	windows[].ai_assistance_score	درجات احتمالية الذكاء الاصطناعي ومساعدة الذكاء الاصطناعي ليست متطابقة. الاستخدام ملصق للحصول على إرشادات.

---

التوثيق

تتوفر وثائق API الكاملة هنا.

---

أسئلة؟

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