دليل الترحيل إلى Pangram 4

دليل الترحيل إلى Pangram 4

أصبحت «بانغرام 4» متاحة الآن عبر واجهة برمجة التطبيقات (API) الخاصة بنا.

نظرًا لبعض التحديثات المتعلقة بالفوترة، لا يزال الإصدار Pangram 3.3.2 هو الإصدار الافتراضي وسيظل متاحًا حتى 30 سبتمبر 2026.

يغطي هذا الدليل كل ما تحتاج إلى معرفته حول الترحيل إلى Pangram 4.

ما الجديد في Pangram 4؟

يقدم Pangram 4 نموذجًا للكشف أكثر دقة، ونظامًا للكشف عن «الإنسانية» لكل مقطع على حدة، ومجموعة مبسطة من تصنيفات التصنيف. راجع بطاقة نموذج Pangram 4 لمزيد من المعلومات!

يظل الهيكل العام للاستجابة كما هو، لذا من المفترض ألا تتطلب معظم عمليات الدمج سوى بضعة تغييرات:

• اطلب «بانغرام 4» صراحةً باستخدام النموذج: "pangram-4"
• التحديث إلى الإصدار 1.0.0 من حزمة SDK الخاصة بلغة بايثون
• ادعم ملصقات النوافذ الجديدة لـ «بانغرام 4»
• يمكنك استخدام حقول «إضفاء الطابع الإنساني» الجديدة إذا رغبت في ذلك
• تحديد حساب عداد الفوترة المحدث لواجهة برمجة التطبيقات (API)

كما يعود «بانغرام 4» أيضًا:

{
  "version": "4.0"
}

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

نعم ، إذا كنت:

• هل تريد البدء في استخدام Pangram 4 قبل أن يصبح الخيار الافتراضي؟
• استخدم ملصقات النوافذ في تطبيقك أو في سير عمل الإنتاج
• هل ترغب في الوصول إلى حقول «التأنيس» الجديدة؟
• تحتاج إلى وقت لاختبار عملية التكامل قبل 30 سبتمبر
• هل ترغب في تقييم نموذج الفوترة المحدث باستخدام أحجام الطلبات المعتادة لديك؟

ليس بعد ، إذا كنت:

• نحتاج إلى مزيد من الوقت للتحقق من صحة «بانغرام 4» في بيئة الاختبار
• تعتمد على سلاسل التسمية الدقيقة لـ Pangram 3.3.2 ولم تقم بتحديث عملية التكامل الخاصة بك
• يجب مراجعة كيفية تأثير نظام الفوترة لكل 100 كلمة على استخدامك

لا يزال «بانغرام 3.3.2» هو الإصدار الافتراضي، وسيظل متاحًا حتى 30 سبتمبر 2026.

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

نوصي باختبار «Pangram 4» قبل 30 سبتمبر، لا سيما إذا كان التكامل الخاص بك يتفرع بناءً على سلاسل نصية محددة لتسميات النوافذ.

ترحيل واجهة برمجة التطبيقات REST

بالنسبة لمن يستخدمون واجهة برمجة التطبيقات REST، يرجى إرسال منشور يرجى توجيه الطلب إلى:

https://text.external-api.pangram.com/task

يجب أن يتضمن نص الطلب الآن ما يلي:

{
  "text": "...",
  "model": "pangram-4"
}

نظرًا لأن الإصدار Pangram 3.3.2 لا يزال هو الإصدار الافتراضي خلال الفترة الانتقالية، يجب عليك طلب الإصدار Pangram 4 صراحةً.

مثال على الطلب

curl --request POST \
  --url https://text.external-api.pangram.com/task \
  --header "Content-Type: application/json" \
  --header "x-api-key: YOUR_API_KEY" \
  --data '{
    "text": "Your text goes here.",
    "model": "pangram-4"
  }'

ترحيل حزمة SDK لـ Python

بالنسبة لمن يستخدمون حزمة تطوير التطبيقات (SDK) الخاصة بلغة بايثون، يرجى التحديث إلى الإصدار 1.0:

pip تثبيت --upgrade pangram-sdk==1.0.0

ثم اطلب «بانغرام 4» بشكل صريح:

من بانغرام استيراد Pangram

client = بانغرام()

النتيجة = العميل.التنبؤ(
    نص،
    نموذج="pangram-4"،
)

وكما هو الحال مع واجهة برمجة التطبيقات REST، يجب اختيار Pangram 4 بشكل صريح خلال الفترة الانتقالية.

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

لا يزال هيكل الاستجابة العام مألوفًا، مع إضافة عنصرين إلى كل «بانغرام 4» windows[] العنصر:

كما يعود «بانغرام 4» أيضًا:

{
  "version": "4.0"
}

ترحيل تسميات النوافذ

التغيير الوحيد الذي قد يشكل تغييرًا جذريًّا هو أن تسميات نوافذ «Pangram 4» أصبحت الآن كما يلي:

• من إنتاج الذكاء الاصطناعي
• بمساعدة الذكاء الاصطناعي
• كتبه الإنسان

بمساعدة الذكاء الاصطناعي يحل محل السابق بمساعدة بسيطة من الذكاء الاصطناعي و مدعوم بالذكاء الاصطناعي بدرجة معتدلة الملصقات.

إذا كان التكامل الخاص بك يتفرع بناءً على سلاسل نصية محددة للتسميات، فيرجى تحديثه قبل إجراء عملية الترحيل.

على سبيل المثال، الكود الذي كان يتعامل سابقًا مع التسميتين المدعومتين بالذكاء الاصطناعي بشكل منفصل:

if window["label"] in {
    "Lightly AI-Assisted",
    "Moderately AI-Assisted",
}:
    handle_ai_assisted(window)

ينبغي تحديثه إلى:

إذا النافذة["label"] == "بمساعدة الذكاء الاصطناعي":
    handle_ai_assisted(window)

قد يبدو معالج العلامات الكامل لـ «بانغرام 4» كما يلي:

التسمية = نافذة["التسمية"]

إذا التسمية == "مُنتج بواسطة الذكاء الاصطناعي":
    handle_ai_generated(window)
elif label == "مدعوم بالذكاء الاصطناعي":
    handle_ai_assisted(window)
elif label == "مكتوب يدويًا":
    handle_human_written(نافذة)
else:
    handle_unknown_label(window)

نوصي بالاحتفاظ بخيار بديل في حالة عدم معرفة التسمية، بدلاً من الافتراض بأن واجهة برمجة التطبيقات (API) ستُرجع دائمًا إحدى السلاسل الموثقة حاليًا.

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

لا تتطلب معظم حقول الاستجابة في Pangram 3.3.2 إجراء أي تغييرات عند الانتقال إلى Pangram 4.

المشكلة الرئيسية المتعلقة بالتوافق هي windows[].label. تم دمج الفئتين السابقتين المدعومتين بالذكاء الاصطناعي في فئة واحدة بمساعدة الذكاء الاصطناعي التسمية.

تغييرات في الفواتير

ملاحظة أخيرة: نحن بصدد تحديث طريقة احتساب رسوم واجهة برمجة التطبيقات (API) الخاصة بنا.

نحن نعمل على تحسين دقة قياس الاستخدام لدينا. سيتم الآن احتساب تكلفة الطلبات لكل 100 كلمة بدلاً من كل 1,000 كلمة. وسيكون ذلك مفيداً للكثيرين منكم.

ولكن نود أن ننبهكم إلى أن «بانغرام 4» هو طراز أكبر حجماً وأكثر كفاءة، ولذلك اضطررنا إلى رفع سعره.

يرجى الاطلاع على صفحة الأسعار للحصول على أحدث المعلومات حول الأسعار!

قبل نقل كل حركة مرور الإنتاج إلى Pangram 4، يرجى مراجعة نموذج الفوترة المحدث مقارنةً بطول الطلبات وحجمها المعتاد في تطبيقك.

عملية الترحيل الموصى بها

1. قم بتحديث برنامج العميل الخاص بك

يمكن لمستخدمي واجهة برمجة التطبيقات REST الاستمرار في استخدام نقطة نهاية المهام الحالية.

يجب على مستخدمي Python SDK تثبيت الإصدار 1.0.0:

pip تثبيت --upgrade pangram-sdk==1.0.0

2. طلب «بانغرام 4» بشكل صريح

أضف معلمة النموذج إلى كل طلب:

{
  "model": "pangram-4"
}

3. تحديث مقارنات التسميات الدقيقة

استبدال عمليات التحقق الخاصة بـ:

بمساعدة طفيفة من الذكاء الاصطناعي
بمساعدة معتدلة من الذكاء الاصطناعي

بمشاركة:

بمساعدة الذكاء الاصطناعي

تأكد أيضًا من أن عملية التكامل الخاصة بك تدعم علامات «Pangram 4» الأربع بالضبط:

من إنتاج الذكاء الاصطناعي
بمساعدة الذكاء الاصطناعي
كتبه الإنسان

4. دعم المجالات الجديدة

تحديث أنواع الاستجابات، ومخططات التحقق من الصحة، ونماذج قواعد البيانات، ومسارات التحليلات لدعم:

windows[].is_humanized
windows[].humanizer_score
الإصدار

يمكن اعتبار حقول النافذة الجديدة اختيارية في البداية إذا كان تطبيقك لا يستخدم تحليل «الإنسانية» بعد.

5. مراجعة الافتراضات المتعلقة بالفوترة

سيتم الآن احتساب رسوم الطلبات على أساس كل 100 كلمة بدلاً من كل 1,000 كلمة.

اختبر التأثير باستخدام حركة مرور إنتاجية تمثيلية.

قائمة مراجعة الهجرة

• تحديث حزمة SDK الخاصة بـ Python إلى pangram-sdk==1.0.0، إن أمكن
• إضافة النموذج: "pangram-4" لطلبات واجهة برمجة التطبيقات (API)
• إزالة التبعيات على بمساعدة بسيطة من الذكاء الاصطناعي
• إزالة التبعيات على مدعوم بالذكاء الاصطناعي بدرجة معتدلة
• الدعم بمساعدة الذكاء الاصطناعي
• إضافة دعم لـ windows[].is_humanized
• إضافة دعم لـ windows[].humanizer_score
• تأكد من أن إصدار الاستجابة هو "4.0"
• اطلع على نظام الفوترة الجديد القائم على كل 100 كلمة
• اختبر عملية الترحيل قبل 30 سبتمبر 2026

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

نحن متحمسون لرؤيتكم تستخدمون Pangram 4. يرجى التواصل معنا إذا واجهتكم أي مشاكل. سنكون أكثر استجابة خلال الأيام القادمة!

للحصول على الدعم في عملية الترحيل، يرجى الاتصال بـ support@pangram.com.