eu/jev: واجهة API لتصنيف النصوص باستضافة ألمانية

eu/jev خدمة مستقلة تديرها Bevelites GmbH وتوفر واجهة لاتخاذ قرارات منظمة من سياق نصي. تناسب المطورين الذين يريدون تصنيف المحتوى أو توجيه طلبات الدعم أو تقييم الخيارات.

ما وظيفة eu/jev؟ شرح بسيط

تخيّل وصول رسالة عن فاتورة غير صحيحة. تحدد فئتي «الفواتير» و«الدعم التقني» وتشرح معنى كل واحدة. تعيد eu/jev اختيارًا ومعلومات عن الاحتمالات، ويمكن لتطبيقك استخدام هذه الحقول لتحديد الخطوة التالية. يعرض Playground طريقة العمل؛ أما ربط النتيجة بنظام الدعم وتنفيذ الإجراء فيحتاج إلى تكامل تطوره أنت.

تحديد الفئات والأسئلة قبل الطلب

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

قراءة الاختيار والاحتمال والدرجة

يختار Choice من 2–10 خيارات ويعيد probabilities وconfidence. تُطبّع الثقة مقارنة بالتخمين المتساوي، ولذلك تختلف عن احتمال الخيار المختار. يعيد Noul احتمال نعم/لا بين 0 و1. يستخدم Score قائمة من 2–10 معايير مرتبة ويعيد موضعًا متوقعًا من 0 إلى N−1 مع احتمالات ودليل تفسير.

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

تجربة طلب API والتحقق من النتيجة

تحتاج إلى حساب مقبول ومفتاح من لوحة الحساب. تُراجع طلبات الوصول حسب القدرة المتاحة؛ إرسال النموذج لا ينشئ حسابًا ولا يضمن القبول. احتفظ بالمفتاح على الخادم.

ضع السياق في state وسؤالًا باسم محدد في questions. أرسل JSON عبر POST إلى https://eu-jev.com/v1/systemone باستخدام Bearer وContent-Type: application/json. اختر jeff-latest أو إصدارًا موثقًا ثابتًا مثل jeff-1.0.0. افحص حالة HTTP أولًا، ثم answers.team.choice وprobabilities وconfidence. يمكن أن تكون state كائن JSON أو مصفوفة أيضًا.

المثال مبني على الوثائق، ولم يُنفذ بمفتاح حقيقي. لا توجد قائمة لغات كاملة منشورة؛ اختبر العربية والنصوص المناسبة لمشروعك.

تتضمن الوثائق الرسمية أيضًا أمثلة HTTP بلُغتَي JavaScript وPython.

curl https://eu-jev.com/v1/systemone \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "jeff-latest",
  "state": "توجد دفعة إضافية في الفاتورة. أرجو التحقق.",
  "questions": {
    "team": {
      "type": "choice",
      "instructions": "اختر الفريق المناسب لمعالجة الرسالة.",
      "criteria": {
        "billing": "الفواتير والمدفوعات واسترداد المبالغ",
        "technical": "الأخطاء والانقطاعات والوصول للحساب"
      }
    }
  }
}'

وثائق API والأخطاء

الرصيد الأولي وتكلفة الاستخدام

تم التحقق في 5 أكتوبر 2026، باليورو: يحصل الحساب الجديد المقبول على رصيد ترويجي لمرة واحدة قدره €5، دون تجديد شهري أو تحصيل تلقائي. السعر €37 لكل مليار رمز إدخال، أي €0.037 لكل مليون، ورموز الإخراج مجانية.

يُحسب السياق والتعليمات والمعايير ورموز الإعداد، وتُحسب state المشتركة مرة واحدة. المدخلات المتكررة أو المخبأة لها السعر نفسه. تُستهلك الأرصدة للنتائج الناجحة فقط، ويستخدم Playground المسجل الرصيد نفسه. نقص الرصيد يوقف الاستدلال مع HTTP 402 insufficient_credits. يُطلب الاستخدام الإضافي بالنموذج الرسمي؛ الدفع يحتاج إلى اتفاق صريح منفصل.

السعر وشروط الخدمة

الاستضافة في ألمانيا ومسارات البيانات

الأصل وقاعدة التطبيق وعملية النموذج لدى Hetzner في ألمانيا، دون وكيل نموذج خارجي أو CDN على مسار الاستدلال الموثق. لا تُحفظ المدخلات والإجابات في قاعدة التطبيق أو سجلاته ولا تُستخدم للتدريب، لكن مخابئ RAM قد تبقى بين الطلبات.

تُحفظ بيانات الحساب والاستخدام والرصيد والأمان، دون حذف آلي قائم على عمر سجلات الحساب والاستخدام. تسجيل Google والبريد والنموذج الخارجي قد تتضمن معالجة خارج المنطقة الاقتصادية الأوروبية، ومنها الولايات المتحدة. لذلك لا تعني الاستضافة الألمانية أن كل البيانات تبقى في الاتحاد الأوروبي. الاستخدام التجاري لبيانات شخصية يحتاج إلى DPA؛ استخدم محتوى اصطناعيًا أو غير شخصي في Playground المجهول.

المعالجة الحساسة أو عالية المخاطر تحتاج إلى شروط مكتوبة وضمانات منفصلة؛ والقرارات المهمة تحتاج إلى مراجعة بشرية مناسبة.

الخصوصية ومعالجة البيانات · اتفاق DPA للاستخدام التجاري

حدود الخدمة والتوافق

المفاتيح وPlayground المسجل تشترك في 60 طلبًا بالدقيقة لكل حساب. المجهول يسمح بـ12 بالدقيقة و100 يوميًا لكل زائر. حدود API: جسم JSON حتى 256 KiB، وstate النصية حتى 100,000 حرف، وثمانية أسئلة، و1000 حرف للتعليمة و500 لكل معيار بعد التحويل. يجب أن يلائم السياق المُعد 32,768 موضعًا تشمل الفروع والتنسيق. حقل Playground له حد مستقل قدره 12,000 حرف.

تُخدم الطلبات واحدًا تلو الآخر، بمفاتيح ذات أولوية وانتظار يصل إلى 20 ثانية في الطابور. التزم بـRetry-After عند 429/503 وعدّل المدخلات عند 422. latency_ms ليست قياسًا كاملًا لزمن الشبكة. توافق TypeSafe يشمل بنية HTTP فقط؛ معرّفات Jev تعيد 400 ولا يُضمن توافق SDK أو تطابق النتائج. التكامل التجاري يخضع للشروط؛ نموذج Winnow الأساسي لا يجعل الخدمة مفتوحة المصدر أو قابلة للاستضافة الذاتية.

أسئلة شائعة

ما الذي تفعله eu/jev عند تصنيف النصوص؟

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

هل أحتاج إلى تدريب نموذج لإنشاء فئات؟

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

هل تعني قيمة الاحتمال أن القرار صحيح دائمًا؟

لا. الاحتمال والثقة مؤشرات تنبؤ، وليسا ضمانًا للصحة. استخدم أمثلة راجعتها وأضف مراجعة بشرية للقرارات المهمة أو غير الواضحة.

هل يتجدد الرصيد الأولي كل شهر؟

لا. تحصل الحسابات المقبولة على €5 مرة واحدة. تخصم الطلبات الناجحة من الرصيد وفق سعر رموز الإدخال؛ الاستخدام الإضافي وأي دفع يحتاجان إلى اتفاق صريح منفصل.

هل تعني الاستضافة الألمانية بقاء كل بيانات الحساب في الاتحاد الأوروبي؟

لا. قد يتضمن Google والبريد والنموذج معالجة خارج المنطقة الاقتصادية الأوروبية. معالجة البيانات الشخصية للأعمال تتطلب DPA؛ موقع الاستدلال لا يصف جميع مسارات الخدمة.

المصادر الرسمية

• الأسئلة الرسمية والنموذج
• طلب الوصول أو الاستخدام الإضافي