إذا كانت مجموعتك التقنية تستخدم بالفعل SDK للذكاء الاصطناعي مبنيًا حول OpenAI، فإن Novita AI تتطلب غالبًا تغيير عنوان الأساس ومفتاح API ومعرف النموذج فقط. يدعم OpenAI TypeScript SDK الرسمي نقاط نهاية مخصصة، وتوفر مستندات Novita نقطة نهاية إكمال المحادثة المتوافقة مع OpenAI على https://api.novita.ai/openai/v1/chat/completions، لذا تكون الخطوة الأولى للترحيل صغيرة. إذا كنت تختار أيضًا أي نموذج مفتوح تريد ربطه بهذا الـ SDK، فابدأ بـ قائمة صدارة نماذج LLM مفتوحة المصدر لوكلاء البرمجة في 2026.
هذا يجعل Novita خيارًا عمليًا إذا أردت الاحتفاظ بسير عمل الـ SDK الحالي واختبار محرك نموذج مختلف دون إعادة كتابة تطبيقك.
وهو مفيد بشكل خاص من أجل:
- تطبيقات Next.js أو Node التي تستدعي
openaiبالفعل - أدوات داخلية تحتاج إلى مسار ترحيل سريع عبر OpenAI SDK
- خلفيات وكلاء سيتم ربطها لاحقًا بـ Novita Agent Sandbox
- فرق تريد مشاركة نفس شكل API المتوافق مع OpenAI بين TypeScript وPython
استخدام OpenAI TypeScript SDK مع Novita AI: ما الذي يتغير وما الذي يبقى كما هو
| العنصر | الإعداد الافتراضي في OpenAI SDK | إعداد Novita AI | لماذا هو مهم؟ |
|---|---|---|---|
| مكتبة العميل | openai |
openai |
حافظ على نفس حزمة TypeScript. |
| عنوان الأساس | نقطة نهاية OpenAI | https://api.novita.ai/openai |
يضيف الـ SDK مسار الإصدار تلقائيًا. |
| مفتاح API | مفتاح OpenAI | مفتاح Novita API | تتغير المصادقة وليس شكل الاستدعاء. |
| اسم النموذج | معرف نموذج OpenAI | معرف نموذج Novita | تعامل مع معرفات النماذج على أنها خاصة بالموفر. |
| أول طلب | chat.completions.create() |
chat.completions.create() |
ابدأ بنفس نمط الطلب. |
كيفية إعداد OpenAI TypeScript SDK مع Novita AI
ثبّت الـ SDK:
npm install openai
ثم وجّهه إلى Novita:
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.NOVITA_API_KEY,
baseURL: "https://api.novita.ai/openai",
});
const response = await client.chat.completions.create({
model: "openai/gpt-oss-120b",
messages: [
{ role: "system", content: "You are a concise technical assistant." },
{ role: "user", content: "Show me the shortest Novita SDK setup in TypeScript." },
],
});
console.log(response.choices[0]?.message?.content);
ابدأ بميزة إكمال المحادثة (chat completions). توثّق مستندات Novita العامة حاليًا مسار إكمال المحادثة المتوافق مع OpenAI، لذا فهذا هو الاختبار الأول الأكثر أمانًا.
مكافئ Python لـ OpenAI SDK على Novita AI
النمط نفسه يعمل في Python:
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["NOVITA_API_KEY"],
base_url="https://api.novita.ai/openai",
)
response = client.chat.completions.create(
model="openai/gpt-oss-120b",
messages=[
{"role": "user", "content": "Explain the Novita setup in one paragraph."}
],
)
print(response.choices[0].message.content)
متى تستخدم Novita Agent Sandbox مع OpenAI SDK
استخدم الـ SDK لاستدعاءات النماذج، ثم استخدم Novita Agent Sandbox عندما تتطلب سير العمل تنفيذ كود، أو إجراءات متصفح، أو العمل على ملفات في بيئة معزولة. يحافظ هذا الفصل على استقلالية الاستدلال عن التنفيذ، وهو الشكل الصحيح لوكلاء البرمجة.
إذا كنت ترحّل أكثر من SDK، فراجع أيضًا دليل OpenAI Python SDK ودليل Novita LLM API.
نصائح ترحيل OpenAI SDK لتجربة أفضل للمطورين
- استخدم
https://api.novita.ai/openaiكعنوان أساسي للـ SDK. يضيف OpenAI SDK مسار الإصدار تلقائيًا، لذلك لا تحتاج إلى إضافة/v1يدويًا. - استبدل بمعرف نموذج مدعوم من Novita قبل الاختبار. يمكن أن يظل كود الـ SDK كما هو، لكن معرفات النماذج خاصة بالموفر.
- تعامل مع التوافق مع OpenAI كاختصار للترحيل، وليس كضمان أن كل ميزة أحدث في المنصة تعمل بالطريقة نفسها. تحقق من مستندات Novita الحالية قبل الإطلاق.
- إذا كانت سير العمل لديك تشغّل كودًا مولّدًا، أو عمليات ملفات، أو إجراءات متصفح، فانقل التنفيذ إلى Agent Sandbox بدلاً من جهازك المحلي.
الأسئلة الشائعة
هل يكفي OpenAI SDK بلغة TypeScript وحده؟
نعم لاستدعاءات النماذج. لا للتنفيذ المعزول. إذا كان التطبيق وكيلًا (agentic)، فاستخدمه مع Agent Sandbox.
هل يمكنني الاحتفاظ بنفس الكود في JavaScript وTypeScript؟
نعم. استخدام الـ SDK هو نفسه.
ماذا ينبغي أن أقرأ بعد ذلك؟
اقرأ دليل Novita LLM API ومرجع إكمال المحادثة، ثم تأكد من معرف النموذج الدقيق في مكتبة النماذج قبل الاستخدام في الإنتاج.
