يشرح هذا الدليل السريع كيفية إرسال أول طلب محادثة نصية (chat-completions) إلى Ling 3.0 Flash Sante عبر واجهة برمجة التطبيقات (API) المتوافقة مع 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 يبلغ 124 مليار معلمة، مع حوالي 5.1 مليار معلمة نشطة لكل رمز، ونافذة سياق تبلغ 262,144 رمزًا، وإخراج أقصى 32,768 رمزًا، وإدخال وإخراج نصي، وقدرات التفكير (reasoning) واستدعاء الدوال (function calling). هذه الصفحة هي دليل التنفيذ، وليست نظرة عامة على الإطلاق؛ للحصول على معلومات حول وضع النموذج، وإرشادات الملاءمة، والأسعار الحالية، راجع Ling 3.0 Flash Sante على Novita AI: API مجاني، المواصفات، والأسعار.
دليل دمج Ling 3.0 Flash Sante مع Python وcURL
استخدم هذه الصفحة عندما يكون السؤال العملي هو كيفية المصادقة، وتأكيد مسار النموذج، وإرسال طلب صغير، وتحليل الاستجابة. صُممت لاختبار التكامل الأولي، وليس لاختيار سير عمل سريري أو التحقق من صحة نموذج لحالة استخدام عالية المخاطر.
Ling 3.0 Flash Sante هو نموذج نصي. يسلط القائمة المُستضافة الضوء على التفكير الطبي، والسلامة السريرية، والاسترجاع القائم على الأدلة، والمهام الطبية طويلة الأمد، بينما يسرد أيضًا القدرات العامة في التفكير، والبرمجة، والعوامل (agentic). تصف هذه التصنيفات مجالات القدرة المقصودة للنموذج؛ ولا تحل محل التقييم على بياناتك، أو التحقق من المصادر، أو ضوابط الخصوصية، أو المراجعة المؤهلة.
الخطوة 1: الحصول على مفتاح API الخاص بك من Novita
أنشئ مفتاح API لـ Novita، ثم احتفظ به خارج نظام التحكم بالمصادر. بالنسبة لاختبار محلي أولي، قم بتصديره كمتغير بيئة:
export NOVITA_API_KEY="your_api_key"
لا تضع المفتاح في حزمة متصفح، أو مستودع عام، أو تطبيق عميل (client-side application). بالنسبة لخدمة مُنشورة، قم بتحميله من مدير الأسرار الخاص بالخدمة وقم بتدويره وفقًا لسياسة بيانات فريقك.
الخطوة 2: تأكيد معرف النموذج ونقطة النهاية
قبل كتابة كود التطبيق، تحقق من صفحة نموذج Ling 3.0 Flash Sante الحية. تم التحقق من القيم أدناه في 4 سبتمبر 2026.
| الحقل | القيمة |
|---|---|
| معرف النموذج | inclusionai/ling-3.0-flash-sante |
| عنوان URL الأساسي | https://api.novita.ai/openai |
| نقطة نهاية chat completions | POST https://api.novita.ai/openai/v1/chat/completions |
| نافذة السياق | 262,144 رمزًا (معروض كـ 256K) |
| أقصى إخراج | 32,768 رمزًا (معروض كـ 32K) |
| الإدخال والإخراج | نص |
| الميزات المُدرَجة | استدعاء الدوال (function calling)، التفكير (reasoning) |
| معدل الطلبات في الكتالوج | 30 طلبًا في الدقيقة |
| سعر الإدخال المُدرَج | $0 لكل 1 مليون رمز |
| سعر الإخراج المُدرَج | $0 لكل 1 مليون رمز |
الأسعار والحدود والتوفر هي قيم كتالوج حية. أعد التحقق منها قبل وضع الميزانية أو نقل التكامل إلى الإنتاج. قيمة معدل الطلبات في الكتالوج ليست وعدًا بأن كل حساب أو عبء عمل سيحصل على نفس الإنتاجية.
الخطوة 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": "You are a concise technical assistant. Do not provide diagnosis or treatment advice."
},
{
"role": "user",
"content": "Return a three-item checklist for testing a text classification API."
}
],
"max_tokens": 256,
"temperature": 0.2
}'
يستخدم الطلب مصفوفة messages القياسية ومعرف النموذج الدقيق. قيمة max_tokens صغيرة عمدًا لاختبار سريع. قم بزيادتها فقط بعد أن يعمل الطلب، وتحليل الاستجابة، ومعالجة المهلة، ومعالجة الأخطاء بشكل موثوق.
الخطوة 4: قراءة الاستجابة
يعيد طلب chat completion ناجح رسالة مساعد في الخيار الأول (first choice). في تطبيق عميل أو خدمة، تحقق من رمز الحالة قبل تحليل JSON، ثم تعامل مع الاستجابة بشكل دفاعي:
{
"choices": [
{
"message": {
"role": "assistant",
"content": "1. Prepare representative labeled inputs.\n2. Measure classification accuracy and refusal behavior.\n3. Inspect errors before increasing traffic."
}
}
]
}
بالنسبة للاختبار الأول، تأكد من أن:
- الطلب يُرجع استجابة HTTP ناجحة؛
choices[0].message.contentيحتوي على نص المساعد؛modelالمُعاد هو النموذج المتوقع عند وجود الحقل؛- تطبيقك يتعامل مع المحتوى المفقود والاستجابات غير 200 والمهلات؛
- السجلات تحتوي على بيانات وصفية للطلب ولكن لا تحتوي أبدًا على مفتاح API أو إدخال حساس غير ضروري.
لا تتعامل مع استجابة HTTP ناجحة كدليل على أن سير عمل طبي أو منظم جاهز. إنها تؤكد فقط أن مسار الطلب هذا، وبيانات الاعتماد، ومعرف النموذج، ومحلل الاستجابة الأساسي يعملون معًا.
الخطوة 5: التحقق من الأسعار والحدود والأخطاء الشائعة
قبل استخدام حركة المرور الحقيقية، أعد التحقق من صفحة النموذج الحية للأسعار، والسياق، وأقصى إخراج، والميزات المدعومة، ومعلومات معدل الطلبات. ثم اختبر الحدود المهمة لتطبيقك: الاستفسارات الطويلة، واقتطاع الإخراج، وإعادة المحاولة، والطلبات المتزامنة، وتحليل استدعاء الأداة.
أكثر إخفاقات المكالمة الأولى شيوعًا هي مباشرة:
- خطأ 401 أو مصادقة:
NOVITA_API_KEYغير معين، منتهي الصلاحية، مشوه، أو لا يتم إرساله كرمز حامل (bearer token). - النموذج غير موجود: يستخدم الطلب اسمًا معروضًا أو خطأ إملائيًا بدلاً من
inclusionai/ling-3.0-flash-sante. - خطأ نقطة النهاية 404: العميل قام بتكرار أو حذف مسار
/v1/chat/completions. استخدم عنوان URL الأساسي فقط في تكوين SDK، أو استخدم عنوان URL الكامل في cURL. - خطأ طلب 400: افحص بناء جملة JSON والحقول المدعومة. ابدأ بـ
modelوmessages، ثم أضف المعلمات الاختيارية واحدة تلو الأخرى. - استجابة 429 للحد من المعدل: طبق التراجع الأسي المحدود (bounded exponential backoff)، وقلل التزامن، وقارن حركة المرور الخاصة بك مع حدود الحساب والكتالوج الحالية.
- إجابة مبتورة: قم بزيادة
max_tokensعندما يحتاج التطبيق إلى مخرجات أكثر، مع البقاء ضمن الحد الأقصى الحالي للنموذج وميزانية السياق الإجمالية الخاصة بك.
مثال بايثون
يمكن استخدام 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": "You are a concise technical assistant. Do not provide diagnosis or treatment advice.",
},
{
"role": "user",
"content": "Explain how to test a text API response parser in three steps.",
},
],
max_tokens=256,
temperature=0.2,
)
print(response.choices[0].message.content)
يستخدم هذا المثال فقط حقول chat-completions الشائعة. بمجرد أن يعمل، أضف تعليمات النظام الخاصة بالتطبيق، أو معالجة الإخراج المنظم، أو الأدوات، واختبر كل تغيير بشكل مستقل.
مثال 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": "List three checks for a reliable JSON response parser."
}
],
"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: تتضمن القائمة استدعاء الدوال. إذا أضفت أدوات، حدد مخططات ضيقة، وتحقق من الوسائط في تطبيقك، واحتفظ بالتنفيذ خارج النموذج.- ضوابط التفكير (Reasoning controls): تتضمن القائمة التفكير، لكن لا تفترض أن كل حقل تفكير اختياري قابل للنقل عبر SDKs. تأكد من مرجع API الحالي وسلوك النموذج قبل إضافة حقول خاصة بالمزود.
بالنسبة للنصوص المتعلقة بالصحة، افصل التوليد عن التحقق. قدم فقط البيانات التي يُصرح لتطبيقك بمعالجتها، واحتفظ بمراجع المصادر حيثما أمكن، وقم بتوجيه المخرجات ذات العواقب إلى مراجعين مؤهلين. لا تقدم هذه المقالة نصائح تشخيصية أو علاجية.
استكشاف الأخطاء وإصلاحها
عندما يفشل الطلب، اختزله إلى أصغر مكالمة قابلة للتكرار: معرف النموذج الدقيق، رسالة مستخدم واحدة، قيمة max_tokens منخفضة، ورأس الحامل (bearer header). هذا يسهل التمييز بين مشكلة الحساب ومشكلة غلاف العميل.
إذا نجحت مكالمة 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، ليس بديلاً عن معرف النموذج في جسم الطلب.
ما نقطة النهاية التي يستخدمها هذا الدليل السريع؟
يستخدم مسار chat-completions المتوافق مع OpenAI على https://api.novita.ai/openai/v1/chat/completions. في تكوين SDK، استخدم https://api.novita.ai/openai كعنوان URL الأساسي واترك SDK يلحق مساره المُرقم.
هل النموذج المُستضاف متعدد الوسائط؟
تحدد قائمة Novita الحالية النص كوسيلة الإدخال والإخراج. لا ترسل محتوى صورة أو صوت ما لم يضيف قائمة النموذج الحية الدعم صراحة.
هل يمكنني استخدام هذا للقرارات السريرية؟
هذا الدليل السريع هو دليل تكامل API، وليس إرشادًا سريريًا. لا تؤسس استجابة API ناجحة السلامة السريرية، أو الدقة الواقعية، أو الملاءمة التنظيمية، أو التفويض لمعالجة المعلومات المحمية. قم بتقييم أي استخدام مقترح مع خبراء مجال مؤهلين والضوابط المطلوبة لبيئتك.
