الترميز باستخدام مفاتيح API

مع مفتاح Coderen API يمكنك استخدام أدوات برمجة تعمل مع API متوافق مع OpenAI. ترسل الأداة طلبات إلى AI-School. تتحقق AI-School من المفتاح والميزانية وفترة الصلاحية والموديلات المسموح بها.

ثم تعالج AI-School الطلب عبر الربط التقني للبيئة.

ماذا تحتاج؟

تحتاج إلى ثلاثة معلومات:

المعلومة	أين تجدها؟
مفتاح API	تحصل عليه من المشرف أو المعلم
نقطة النهاية	https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1
اسم النموذج	على سبيل المثال gpt-5.6-luna، gpt-5.6-terra أو gpt-5.6-sol

مفتاح API يبدأ بـ ais.. تعامل مع هذا المفتاح ككلمة مرور.

أي نموذج تختاره؟

بالنسبة لمعظم الطلاب يعتبر GPT-5.6 Luna بداية جيدة. هذا النموذج السريع مناسب للمساعدة البرمجية أثناء الدرس ولأسئلة الشفرة اليومية.

بالنسبة للمعلمين أو الطلاب المتقدمين، يناسب GPT-5.6 Terra مشاريع أكبر ورمز أكثر تعقيداً. اختَر GPT-5.6 Sol للمهام الأكثر تطلباً مع الكثير من التحليل والتخطيط أو التفكير.

أي أداة تختار؟

AI-School يوصي بأداتين:

الأداة	المناسبة لها	السبب
Aider	الطلاب والبرمجة الصفية	تعمل بشكل صريح وواضح وأقل اعتماداً على الوكلاء
OpenCode	المعلمون والمستخدمون المتقدمون	أداة CLI وكالة مع تطبيق سطح مكتب أيضاً

Aider للطلاب

يعمل Aider كأداة برمجة زوجية في المحطة الطرفية. يطلب المستخدم المساعدة، يرى التغييرات ويبقى قريباً من الشفرة. هذا مناسب لتعلم البرمجة: يحصل الطالب على الدعم، ولكنه يظل مشاركاً في ما يحدث.

انظر أيضاً توثيق Aider الرسمي.

OpenCode للاستخدام المتقدم

OpenCode أكثر وكالياً. يمكن للأداة تنفيذ خطوات بشكل مستقل، وتعديل الملفات وتطوير المهام. هذا قوي، ولكنه يتطلب فهماً أكبر للشفرة وGit وبيئات التطوير المحلية.

انظر أيضاً توثيق OpenCode الرسمي.

الاستخدام الآمن للمفاتيح

لا تشارك مفتاح API علناً ولا تضعه في الشفرة التي تشاركها.

يفضل استخدام:

• متغيرات البيئة
• ملف .env محلي لا يتم إرساله إلى Git
• الإعداد المدمج للأداة

بالنسبة لـ OpenCode يمكنك على سبيل المثال استخدام .env في مجلد المشروع:

AI_SCHOOL_CODEREN_API_KEY=ais.jouw-api-sleutel

تأكد من أن الأداة تقوم بتحميل هذا الملف .env فعلاً. في PowerShell يمكنك أيضاً تعيين المتغير مؤقتاً للنافذة الطرفية الحالية:

$env:AI_SCHOOL_CODEREN_API_KEY="ais.jouw-api-sleutel"

انتباه

لا تضع مفاتيح API في مستودع عام، أو دردشة Teams، أو مستند مشترك، أو لقطة شاشة.

إذا لم يعمل المفتاح

تحقق من:

• ما إذا كان Coderen مفعلاً للبيئة
• ما إذا كان مفتاحك لا يزال نشطاً
• ما إذا كانت الميزانية لا تزال كافية
• ما إذا كان المفتاح يقع ضمن فترة الصلاحية المحددة
• ما إذا كنت تستخدم نموذجاً مسموحاً به
• ما إذا كان endpoint مكوَّناً بشكل صحيح
• ما إذا كانت الأداة ترسل مفتاح API ك Authorization: Bearer ...
• ما إذا كانت الأداة لا ترسل معلمات خاصة بمزود الخدمة لا تدعمها AI-School Coderen

استشر المشرف أو المعلم عند وجود شكوك في المفتاح.