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