دليل شامل ومبسط يشرح للمطورين كيفية استغلال وتكامل الـ API الخاصة بنموذج الذكاء الاصطناعي Grok لبناء تطبيقات متطورة ومواكبة للتريند التقني الحالي.

أصبح دمج أدوات الذكاء الاصطناعي داخل التطبيقات البرمجية مهارة أساسية لكل مطور يتطلع للمستقبل ومواكبة سوق العمل. في هذا الدليل العملي من منصة نوفيل، سنتعلم خطوة بخطوة كيفية التعامل مع واجهة برمجة التطبيقات Grok API، بدءاً من إعداد بيئة العمل وحتى إرسال أول طلب (Request) واستقبال الإجابة داخل كودك البرمجي.
قبل كتابة الكود، نحتاج إلى تثبيت المكتبة الرسمية الخاصة بالتعامل مع النموذج. يمكنك تثبيتها بناءً على بيئة العمل التي تفضلها:
pip install openai(ملاحظة: تتوفر مكتبة xAI الرسمية، ولكنها متوافقة تماماً مع معايير مكتبة openai لتسهيل النقل).
npm install openaiلحماية بياناتك وتجنب تسريب المفاتيح الخاصة بك على منصات مثل GitHub، يُنصح دائماً بحفظ الـ API Key داخل ملف .env كمتغير بيئي (Environment Variable):
XAI_API_KEY="أدخل_مفتاح_الـ_API_الخاص_بموقع_xAI_هنا"إليك كود جاهز يقوم بإنشاء اتصال مع السيرفر وإرسال سؤال واستقبال الإجابة بدقة:
import os
from openai import OpenAI
# جلب المفتاح من متغيرات البيئة
XAI_API_KEY = os.getenv("XAI_API_KEY")
client = OpenAI(
api_key=XAI_API_KEY,
base_url="https://api.x.ai/v1",
)
completion = client.chat.completions.create(
model="grok-beta", # أو اسم النموذج المتاح حالياً في حسابك
messages=[
{"role": "system", "content": "أنت مساعد برمي ذكي ومحترف في منصة نوفيل للتعليم."},
{"role": "user", "content": "اشرح لي باختصار مفهوم الـ API وكيف يعمل؟"}
]
)
print(completion.choices[0].message.content)إذا كنت تبني خلفية موقعك باستخدام JavaScript، يمكنك استخدام الكود التالي:
import OpenAI from "openai";
const openai = new OpenAI({
apiKey: process.env.XAI_API_KEY,
baseURL: "https://api.x.ai/v1",
});
async function main() {
const completion = await openai.chat.completions.create({
model: "grok-beta",
messages: [
{ role: "system", content: "أنت مساعد برمي ذكي ومحترف في منصة نوفيل للتعليم." },
{ role: "user", content: "اشرح لي باختصار مفهوم الـ API وكيف يعمل؟" },
],
});
console.log(completion.choices[0].message.content);
}
main();