إذا كانت مجموعتك التقنية تستخدم بالفعل SDK للذكاء الاصطناعي مبنيًا حول OpenAI، فإن Novita AI تتطلب في الغالب تغيير عنوان URL الأساسي ومفتاح API ومعرّف النموذج فقط. يدعم OpenAI TypeScript SDK الرسمي نقاط نهاية مخصصة، وتوثّق Novita نقاط نهاية متوافقة مع OpenAI لمحادثات الإكمال على https://api.novita.ai/openai/v1/chat/completions، لذا فإن خطوة الترحيل الأولى صغيرة.
هذا يجعل Novita خيارًا عمليًا عندما تريد الحفاظ على سير عمل SDK الحالي واختبار خلفية نماذج مختلفة دون إعادة كتابة تطبيقك.
OpenAI TypeScript SDK مع Novita AI: ما الذي يتغير وما الذي يبقى كما هو
| العنصر | إعداد OpenAI SDK الافتراضي | إعداد Novita AI | لماذا يهم |
|---|---|---|---|
| مكتبة العميل | openai |
openai |
احتفظ بنفس حزمة TypeScript. |
| عنوان URL الأساسي | نقطة نهاية 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);
ابدأ بمحادثات الإكمال. توثّق 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 عندما يتطلب سير العمل تنفيذ كود أو إجراءات متصفح أو عمليات ملفات في بيئة معزولة. هذا الفصل يبقي الاستدلال والتنفيذ منفصلين، وهو الشكل الصحيح لوكلاء البرمجة.
نصائح ترحيل OpenAI SDK لتجربة مطوّر أفضل
- استخدم
https://api.novita.ai/openaiكعنوان URL أساسي لـ SDK. يضيف OpenAI SDK المسار المُصدَّر تلقائيًا، لذا لا تحتاج إلى إضافة/v1يدويًا. - استبدل بمعرّف نموذج مدعوم من Novita قبل الاختبار. يمكن أن يبقى كود SDK كما هو، لكن معرّفات النماذج خاصة بالموفر.
- تعامل مع التوافق مع OpenAI كاختصار للترحيل، وليس كضمان أن كل ميزة أحدث في المنصة تتصرف بنفس الطريقة. تحقق من وثائق Novita الحالية قبل الإطلاق.
- إذا كان سير عملك يشغّل كودًا مُولَّدًا أو عمليات ملفات أو إجراءات متصفح، انقل التنفيذ إلى Agent Sandbox بدلاً من جهازك المحلي.
الأسئلة الشائعة
هل يكفي OpenAI TypeScript SDK وحده؟
نعم لاستدعاءات النماذج. لا للتنفيذ المعزول. إذا كان التطبيق وكيلًا، فاقرنه بـ Agent Sandbox.
هل يمكنني الاحتفاظ بنفس الكود في JavaScript و TypeScript؟
نعم. استخدام SDK هو نفسه.
ماذا يجب أن أقرأ بعد ذلك؟
اقرأ دليل Novita LLM API ومرجع محادثات الإكمال، ثم تأكد من معرّف النموذج الدقيق في مكتبة النماذج قبل الاستخدام في الإنتاج.
