البرمجة باستخدام مفاتيح API
باستخدام مفتاح Coderen API يمكنك استخدام أدوات البرمجة التي تعمل مع واجهة OpenAI-متوافقة. ترسل الأداة الطلبات إلى AI-Corporate. يتحقق AI-Corporate من المفتاح، والميزانية، وفترة الصلاحية، والنماذج المسموح بها.
ثم يعالج AI-Corporate الطلب من خلال الربط الفني للبيئة.
ماذا تحتاج؟
تحتاج إلى ثلاث معلومات:
| المعطى | أين تجد هذا؟ |
|---|---|
| مفتاح API | تحصل عليه من مدير النظام |
| نقطة النهاية (Endpoint) | https://europe-west1-ai-corporate.cloudfunctions.net/coderenOpenAiCompatibleApi/v1 |
| اسم النموذج | على سبيل المثال gpt-5.6-luna, gpt-5.6-terra أو gpt-5.6-sol |
يبدأ مفتاح API بـ aic.. تعامل مع هذا المفتاح ككلمة مرور.
أي أداة تختار؟
يُوصي AI-Corporate بـ OpenCode لمعظم المستخدمين. OpenCode هي أداة برمجة قائمة على الوكالات للطرفية والسطح المكتبي وIDE. تستطيع الأداة تنفيذ خطوات مستقلة، وتحرير الملفات، وتطوير المهام بشكل إضافي.
Aider (https://aider.chat/) متوافقة تقنيًا مع نقطة نهاية متوافقة مع OpenAI، لكنها ليست مفضلة كأداة افتراضية في بيئات الشركات.
انظر أيضًا وثائق OpenCode الرسمية (https://opencode.ai/docs/).
التعامل الآمن مع المفاتيح
لا تشارك مفتاح API بشكل علني ولا تضعه في كود تشاركه.
يفضل استخدام:
- متغيرات البيئة
- ملف
.envمحلي لا يتم رُسله إلى git - الإعدادات المدمجة في الأداة
لا تضع مفاتيح API في مستودع عام أو دردشة عامة أو مستند مشترك أو لقطة شاشة.
إذا لم يعمل المفتاح
تحقق من ما يلي:
- هل تم تشغيل Coderen للبيئة
- هل ما زال المفتاح نشطًا
- هل الميزانية منتهية
- هل يقع المفتاح ضمن فترة الصلاحية المحددة
- هل تستخدم نموذجًا مسموحًا به
- هل تم إعداد نقطة النهاية بشكل صحيح
إذا كنت مترددًا، اطلب من مدير النظام فحص المفتاح.
متغيرات البيئة وOpenCode
بالنسبة لـ OpenCode يمكنك حفظ مفتاح Coderen API في ملف محلي .env ضمن مشروعك:
AI_SCHOOL_CODEREN_API_KEY=ais.مفتاح-الـAPI-الخاص-بك
تأكد من أن OpenCode يحمل هذه المتغيرات البيئية فعليًا. في PowerShell يمكنك أيضًا تعيين المتغير مؤقتًا للدرجة الحالية من الطرفية:
$env:AI_SCHOOL_CODEREN_API_KEY="ais.مفتاح-الـAPI-الخاص-بك"
إذا ظهرت لك Authorization header with Bearer token is required، فسيقوم الأداة بإرسال المفتاح بدونها كـ Authorization: Bearer .... إذا ظهرت لك Unknown parameter، فاحذف الإعدادات الخاصة بمزود المزود التي لا تدعمها نقطة النهاية Coderen من AI-Corporate.
