بدء الاستخدام السريع لـ Ling 3.0 Flash Sante لإكمال الدردشة المتوافق مع OpenAI

يشرح هذا الدليل السريع كيفية إرسال أول طلب لإكمال الدردشة النصية إلى Ling 3.0 Flash Sante عبر واجهة برمجة التطبيقات المتوافقة مع OpenAI من Novita. استخدم https://api.novita.ai/openai كعنوان URL الأساسي، وinclusionai/ling-3.0-flash-sante كمعرّف النموذج، وPOST https://api.novita.ai/openai/v1/chat/completions كمسار الطلب. يصف الإدراج الحالي لـ Novita نموذجًا من نوع Mixture-of-Experts بحجم 124B مع حوالي 5.1B معلمة نشطة لكل رمز مميز، ونافذة سياق بحجم 262,144 رمزًا، وإخراج أقصى بحجم 32,768 رمزًا، وإدخال وإخراج نصي، واستدلال، واستدعاء دالة. للحصول على سياق تحديد موضع النموذج والتسعير، راجع Ling 3.0 Flash Sante على Novita AI: القدرات والتسعير.

متى تستخدم هذا الدليل السريع

استخدم هذه الصفحة عندما يكون السؤال العملي هو كيفية المصادقة، وتأكيد مسار النموذج، وإرسال طلب صغير، وتحليل الاستجابة. صُممت لاختبار تكامل أولي، وليس لاختيار سير عمل سريري أو التحقق من صحة نموذج لحالة استخدام عالية المخاطر.

Ling 3.0 Flash Sante هو نموذج نصي. يسلط الإدراج المستضاف الضوء على المعرفة الطبية الاستدلالية، والسلامة السريرية، والاسترجاع القائم على الأدلة، والمهام الطبية طويلة المدى، مع سرد أيضًا القدرات العامة في الاستدلال والبرمجة والعمل الوكيل. تصف هذه التصنيفات مجالات القدرة المقصودة للنموذج؛ أنها لا تحل محل التقييم على بياناتك، أو التحقق من المصادر، أو ضوابط الخصوصية، أو المراجعة المؤهلة.

الخطوة 1: الحصول على مفتاح واجهة برمجة التطبيقات لـ Novita

أنشئ مفتاح واجهة برمجة تطبيقات لـ Novita، ثم احتفظ به خارج نظام التحكم بالمصادر. لاختبار تدخيني محلي، قم بتصديره كمتغير بيئة:

export NOVITA_API_KEY="your_api_key"

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

الخطوة 2: تأكيد معرّف النموذج ونقطة النهاية

قبل كتابة كود التطبيق، تحقق من صفحة نموذج Ling 3.0 Flash Sante المباشرة. تم التحقق من القيم أدناه في 4 سبتمبر 2026.

الحقل	القيمة
معرّف النموذج	inclusionai/ling-3.0-flash-sante
عنوان URL الأساسي	https://api.novita.ai/openai
نقطة نهاية إكمال الدردشة	POST https://api.novita.ai/openai/v1/chat/completions
نافذة السياق	262,144 رمزًا (معروضة كـ 256K)
الإخراج الأقصى	32,768 رمزًا (معروضة كـ 32K)
الإدخال والإخراج	نص
الميزات المدرجة	استدعاء دالة، استدلال
معدل طلبات الكتالوج	30 طلبًا في الدقيقة
سعر الإدخال المدرج	$0 لكل 1M رمز
سعر الإخراج المدرج	$0 لكل 1M رمز

التسعير والحدود والتوفر هي قيم كتالوج مباشرة. أعد التحقق منها قبل إعداد الميزانية أو نقل التكامل إلى الإنتاج. قيمة معدل طلبات الكتالوج ليست وعدًا بأن كل حساب أو عبء عمل سيحصل على نفس الإنتاجية.

الخطوة 3: إرسال طلبك الأول

ابدأ بمطالبة قصيرة غير حساسة. طلب صغير يعزل أخطاء المصادقة والتوجيه قبل إضافة سياق طويل أو أدوات أو بيانات خاصة بالتطبيق.

curl "https://api.novita.ai/openai/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${NOVITA_API_KEY}" \
  -d '{
    "model": "inclusionai/ling-3.0-flash-sante",
    "messages": [
      {
        "role": "system",
        "content": "أنت مساعد تقني موجز. لا تقدم نصائح تشخيصية أو علاجية."
      },
      {
        "role": "user",
        "content": "أعد قائمة مرجعية من ثلاثة بنود لاختبار واجهة برمجة تطبيقات لتصنيف النصوص."
      }
    ],
    "max_tokens": 256,
    "temperature": 0.2
  }'

يستخدم الطلب مصفوفة messages القياسية والمعرّف الدقيق للنموذج. قيمة max_tokens صغيرة عمدًا لاختبار تدخيني. قم بزيادتها فقط بعد أن يعمل الطلب وتحليل الاستجابة ومعالجة المهلات ومعالجة الأخطاء بشكل موثوق.

الخطوة 4: قراءة الاستجابة

يقوم إكمال الدردشة الناجح بإرجاع رسالة مساعد في الخيار الأول. في عميل أو خدمة، تحقق من رمز الحالة قبل تحليل JSON، ثم تعامل مع الاستجابة بطريقة دفاعية:

{
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "1. تحضير مدخلات ممثلة موسومة.\n2. قياس دقة التصنيف وسلوك الرفض.\n3. فحص الأخطاء قبل زيادة حركة المرور."
      }
    }
  ]
}

بالنسبة للاختبار الأول، تأكد مما يلي:

• أن الطلب يُرجع استجابة HTTP ناجحة؛
• أن choices[0].message.content يحتوي على نص المساعد؛
• أن model المُعاد هو النموذج المتوقع عند وجود الحقل؛
• أن تطبيقك يتعامل مع المحتوى المفقود والاستجابات بخلاف 200 والمهلات؛
• أن السجلات تحتوي على بيانات وصفية للطلب ولكن ليس مفتاح API أو مدخلات حساسة غير ضرورية.

لا تتعامل مع استجابة HTTP ناجحة كدليل على أن سير العمل الطبي أو المنظم جاهز. إنها تؤكد فقط أن مسار الطلب وبيانات الاعتماد ومعرّف النموذج ومحلل الاستجابة الأساسي يعملون معًا.

الخطوة 5: التحقق من التسعير والحدود والأخطاء الشائعة

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

أكثر حالات فشل الطلب الأول شيوعًا هي حالات مباشرة:

• خطأ 401 أو خطأ في المصادقة: NOVITA_API_KEY غير مضبوط، أو منتهي الصلاحية، أو مشوه، أو لا يتم إرساله كرمز bearer.
• النموذج غير موجود: يستخدم الطلب اسمًا عرضيًا أو خطأ إملائيًا بدلاً من inclusionai/ling-3.0-flash-sante.
• خطأ 404 في نقطة النهاية: قام العميل بتكرار أو حذف مسار /v1/chat/completions. استخدم عنوان URL الأساسي فقط في تكوين SDK، أو استخدم عنوان URL الكامل في cURL.
• خطأ 400 في الطلب: افحص بناء JSON والحقول المدعومة. ابدأ بـ model و messages، ثم أضف المعلمات الاختيارية واحدة تلو الأخرى.
• استجابة 429 حد معدل: طبق التراجع الأسي المحدود، وقلل من التزامن، وقارن حركة المرور الخاصة بك مع حدود الحساب والكتالوج الحالية.
• إجابة مقتطعة: قم بزيادة max_tokens عندما يحتاج التطبيق إلى إخراج أكثر، مع البقاء ضمن الحد الأقصى الحالي للنموذج وميزانية السياق الإجمالية.

مثال Python

يمكن استخدام SDK الخاص بـ OpenAI لعنوان URL الأساسي المتوافق مع Novita. قم بتثبيت SDK في بيئتك الخاصة، واحتفظ بـ NOVITA_API_KEY مضبوطًا، وقم بتشغيل هذا المثال من عملية من جانب الخادم:

import os

from openai import OpenAI


client = OpenAI(
    base_url="https://api.novita.ai/openai",
    api_key=os.environ["NOVITA_API_KEY"],
)

response = client.chat.completions.create(
    model="inclusionai/ling-3.0-flash-sante",
    messages=[
        {
            "role": "system",
            "content": "أنت مساعد تقني موجز. لا تقدم نصائح تشخيصية أو علاجية.",
        },
        {
            "role": "user",
            "content": "اشرح كيفية اختبار محلل استجابة واجهة برمجة تطبيقات نصية في ثلاث خطوات.",
        },
    ],
    max_tokens=256,
    temperature=0.2,
)

print(response.choices[0].message.content)

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

مثال cURL

لفحص التكامل قائم على الصدفة، احتفظ بالطلب في سكريبت وافشل بصوت عالٍ عند أخطاء HTTP:

curl --fail-with-body "https://api.novita.ai/openai/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${NOVITA_API_KEY}" \
  -d '{
    "model": "inclusionai/ling-3.0-flash-sante",
    "messages": [
      {
        "role": "user",
        "content": "اذكر ثلاثة فحوصات لمحلل استجابة JSON موثوق."
      }
    ],
    "max_tokens": 256,
    "temperature": 0.2
  }'

--fail-with-body تجعل cURL يُرجع حالة فشل لأخطاء HTTP مع الاحتفاظ بنص الاستجابة للتصحيح. لا تلصق هذا النص في سجلات عامة إذا كان يحتوي على مطالبات أو بيانات حساسة أخرى.

المعلمات الرئيسية

• model: استخدم معرّف النموذج المستضاف بالضبط، inclusionai/ling-3.0-flash-sante.
• messages: قدم تاريخ المحادثة ككائنات دور/محتوى. اجعل تعليمات النظام محددة واجعل تنسيق الإخراج المتوقع واضحًا.
• max_tokens: حدد سقف إخراج مناسب للمهمة. الحد الأقصى الحالي للكتالوج هو 32,768 رمزًا، لكن القيم الأصغر تجعل الاختبارات المبكرة أسهل في الفحص.
• temperature: يمكن أن تجعل القيمة المنخفضة اختبارات الاستخراج أو التصنيف القابلة للتكرار أسهل في المقارنة. قم بقياس التأثير على مطالباتك الخاصة بدلاً من افتراض أن إعدادًا واحدًا هو الأفضل عالميًا.
• tools: يتضمن الإدراج استدعاء الدوال. إذا أضفت أدوات، فحدد مخططات ضيقة، وتحقق من الوسائط في تطبيقك، وأبق التنفيذ خارج النموذج.
• ضوابط الاستدلال: يتضمن الإدراج الاستدلال، لكن لا تفترض أن كل حقل استدلال اختياري قابل للنقل عبر SDKs. أكد مرجع API الحالي وسلوك النموذج قبل إضافة حقول خاصة بالموفر.

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

استكشاف الأخطاء وإصلاحها

عندما يفشل طلب، اختزله إلى أصغر استدعاء قابل للتكرار: معرّف النموذج الدقيق، رسالة مستخدم واحدة، قيمة max_tokens منخفضة، ورأس bearer. هذا يجعل من السهل التمييز بين مشكلة الحساب ومشكلة غلاف العميل.

إذا نجح استدعاء cURL الأدنى ولكن فشل استدعاء SDK، فاطبع عنوان URL المطلوب الذي تم حله بواسطة SDK في بيئة تصحيح محلية آمنة وقارنه بـ https://api.novita.ai/openai/v1/chat/completions. لا تطبع رؤوس التفويض. إذا نجح كلا الاستدعاءين ولكن إخراج التطبيق غير موثوق، فاحتفظ باختبار التكامل والوصول إلى النموذج منفصلاً عن تقييم جودة المهمة.

بالنسبة للعمل ذي السياق الطويل، ابدأ أقل من سقف سياق 262,144 رمزًا. قم بعد رسائل الإدخال وتعريفات الأدوات والإخراج المتوقع معًا، ثم اختبر سلوك الاقتطاع والمهلة مع طلبات ممثلة. السياق الكبير المُعلن عنه لا يضمن أن كل مطالبة ستكون مفيدة أو اقتصادية.

الأسئلة الشائعة

ما معرّف النموذج الذي يجب أن أرسله؟

أرسل inclusionai/ling-3.0-flash-sante. الاسم العرضي، Ling 3.0 Flash Sante، ليس بديلاً عن معرّف النموذج في نص الطلب.

ما نقطة النهاية التي يستخدمها هذا الدليل السريع؟

يستخدم مسار إكمال الدردشة المتوافق مع OpenAI على https://api.novita.ai/openai/v1/chat/completions. في تكوين SDK، استخدم https://api.novita.ai/openai كعنوان URL الأساسي واترك SDK يلحق مساره ذو الإصدار.

هل النموذج المستضاف متعدد الوسائط؟

يحدد إدراج Novita الحالي النص كوسيلة الإدخال والإخراج. لا ترسل محتوى صور أو صوت ما لم يضف إدراج النموذج المباشر دعمًا صريحًا.

هل يمكنني استخدام هذا للقرارات السريرية؟

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

مقالات موصى بها

• Ling 3.0 Flash على Novita AI: واجهة برمجة تطبيقات الاستدلال الوكيلية وقدرات النموذج
• بدء الاستخدام السريع لـ Ling 3.0 Tiny لإكمال الدردشة المتوافق مع OpenAI
• خيارات LLM API: تصنيف عملي للمطورين