OpenAI SDK لجافا سكريبت (Node.js): دليل شامل مع أمثلة عملية

مرحبًا بك في الدليل الأكثر شمولاً لاستخدام OpenAI SDK الرسمي للغة JavaScript في بيئة Node.js. هذا المقال أُعد خصيصًا لبوابة PythonLib التعليمية، لمساعدة المطورين من جميع المستويات على دمج قدرات الذكاء الاصطناعي من OpenAI بسرعة وكفاءة في تطبيقات الويب، البوتات، والحلول الخادمية الخاصة بهم.

1. ما هي هذه المكتبة ولماذا تحتاجها؟

OpenAI SDK لجافا سكريبت هي مكتبة رسمية مقدمة من شركة OpenAI للتفاعل مع API الخاص بها من التطبيقات المكتوبة بلغة JavaScript (Node.js). إنها عبارة عن غلاف مريح (wrapper) فوق REST API، يتولى كل المهام الروتينية نيابة عنك: تكوين طلبات HTTP، معالجة الردود، إدارة المصادقة، إعادة المحاولة عند أخطاء الشبكة، والبث المباشر للبيانات (streaming). بدلاً من كتابة طلبات fetch يدويًا، ومعالجة JSON، وإدارة التوكنات، تحصل على واجهة بديهية تحتوي على دوال بأسماء واضحة مثل chat.completions.create()، embeddings.create()، images.generate() وغيرها.

لماذا تحتاج هذه المكتبة؟ أولاً، تُسرّع عملية التطوير بشكل كبير. فبدلاً من عشرات الأسطر البرمجية لطلب واحد من ChatGPT، تكتب فقط 3-5 أسطر. ثانيًا، تتعامل SDK تلقائيًا مع الأمور المعقدة مثل البث المباشر (streaming) - حيث يأتي الرد من النموذج على أجزاء، وهو أمر بالغ الأهمية لإنشاء واجهات محادثة تعرض النص "أثناء التوليد". ثالثًا، تدعم المكتبة TypeScript بشكل افتراضي، وتوفر تصنيفًا كاملاً (typing) لجميع الطلبات والردود، مما يسمح باكتشاف الأخطاء أثناء كتابة الكود وليس أثناء التشغيل. وأخيرًا، هذه الأداة رسمية ويتم تحديثها مع API، لذا سيكون لديك دائمًا إمكانية الوصول إلى أحدث النماذج والوظائف مثل GPT-4o و DALL-E 3 و Whisper و TTS.

هذه المكتبة مثالية لإنشاء روبوتات المحادثة (chatbots)، المساعدين الأذكياء، أنظمة تحليل النصوص، توليد المحتوى، الترجمة، التلخيص، وكذلك للتكامل مع أطر العمل مثل Express.js و Next.js و Telegram Bot API. إذا كنت تكتب كودًا باستخدام Node.js وتريد إضافة "عقل" OpenAI إلى مشروعك، فهذه SDK هي اختيارك الأمثل.

2. التثبيت

يتم تثبيت المكتبة عبر مدير الحزم npm. تأكد من أن لديك Node.js الإصدار 18 أو أعلى (يُوصى بالإصدار 20 LTS).

الأمر الدقيق للتثبيت:

npm install openai

إذا كنت تستخدم yarn:

yarn add openai

بعد التثبيت، ستحتاج إلى مفتاح API من OpenAI للعمل. يمكنك الحصول عليه من صفحة platform.openai.com/api-keys. يجب حفظ المفتاح بشكل آمن، مثلاً في متغير بيئة باسم OPENAI_API_KEY.

3. البداية السريعة - مثال عملي بسيط

لنكتب سكريبتًا بسيطًا يطرح سؤالاً على نموذج GPT-4o ويطبع الرد. أنشئ ملفًا باسم quickstart.mjs (باستخدام وحدات ES) أو quickstart.js (لـ CommonJS).

// quickstart.mjs — باستخدام وحدات ES
import OpenAI from "openai";

const openai = new OpenAI({
  apiKey: process.env["OPENAI_API_KEY"], // المفتاح من متغير البيئة
});

async function main() {
  const completion = await openai.chat.completions.create({
    model: "gpt-4o",
    messages: [
      { role: "system", content: "أنت مساعد مفيد." },
      { role: "user", content: "اكتب تحية قصيرة باللغة العربية." },
    ],
  });

  console.log(completion.choices[0].message.content);
}

main();

قم بتشغيل السكريبت:

export OPENAI_API_KEY="sk-..." # Linux/macOS
set OPENAI_API_KEY="sk-..."   # Windows (CMD)
node quickstart.mjs