الترميز باستخدام مفاتيح API
مع مفتاح API للترميز يمكنك استخدام أدوات الترميز التي تعمل مع API متوافقة مع OpenAI. ترسل الأداة الطلبات إلى AI-Corporate. تتحقق AI-Corporate من المفتاح والميزانية وفترة الصلاحية والنماذج المسموح بها.
ثم تقوم AI-Corporate بمعالجة الطلب عبر الربط التقني للبيئة.
ماذا تحتاج؟
ستحتاج إلى ثلاثة بيانات:
| المعطى | أين تجدها؟ |
|---|---|
| مفتاح API | تحصل عليه من مدير النظام |
| النقطة النهائية (Endpoint) | https://europe-west1-ai-corporate.cloudfunctions.net/coderenOpenAiCompatibleApi/v1 |
| اسم النموذج | على سبيل المثال gpt-5.4-mini, gpt-5.4 أو gpt-5.5 |
يبدأ مفتاح API بـ aic.. تعامل مع هذا المفتاح وكأنه كلمة مرور.
أي أداة تختار؟
توصي AI-Corporate بـ OpenCode لغالبية المستخدمين. OpenCode هي أداة ترميز توليدية تعمل على المحطة الطرفية والسطح المكتبي وIDE. يمكن للأداة تنفيذ خطوات بصورة مستقلة، وتحرير الملفات وتوسيع المهام.
يعتبر Aider متوافقاً تقنياً مع نقطة نهاية متوافقة مع OpenAI، ولكنه لا يُنصح به كأداة افتراضية داخل بيئات Corporate.
انظر أيضاً توثيق OpenCode الرسمي.
التعامل الآمن مع المفاتيح
لا تشارك مفتاح API بشكل علني ولا تضعه في الشيفرات التي تشاركها.
يفضل استخدام:
- المتغيرات البيئية
- ملف
.envمحلي لا يُرسل إلى git - الإعداد المدمج لأداة الإعداد
لا تضع مفاتيح API في مستودع عام، أو دردشة، أو مستند مشترك، أو لقطة شاشة.
إذا لم يكن المفتاح يعمل
تحقق من التالي:
- هل تم تفعيل Coderen للبيئة
- هل مفتاحك لا يزال نشطاً
- هل الميزانية لم تنفد
- هل المفتاح يقع ضمن فترة الصلاحية المحددة
- هل تستخدم نموذجاً مسموحاً به
- هل تم ضبط نقطة النهاية بشكل صحيح
اطلب من مدير النظام التحقق من المفتاح إذا وجدت شكاً.
المتغيرات البيئية وOpenCode
بالنسبة لـ OpenCode يمكنك حفظ مفتاح Coderen في ملف محلي .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.