الترميز بمفاتيح API
مع مفتاح Coderen API يمكنك استخدام أدوات الترميز التي تعمل مع واجهة API متوافقة مع OpenAI. ترسل الأداة الطلبات إلى AI-Public. تتحقق AI-Public من المفتاح والميزانية وفترة الصلاحية Models المسموحة.
بعدها تقوم AI-Public بمعالجة الطلب من خلال الربط الفني للبيئة.
ما تحتاجه؟
تحتاج إلى ثلاث معلومات:
| المعطى | أين تجد هذا؟ |
|---|---|
| مفتاح API | تحصل عليه من مدير النظام |
| نقطة النهاية | https://europe-west1-ai-public-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1 |
| اسم النموذج | على سبيل المثال gpt-5.4-mini, gpt-5.4 أو gpt-5.5 |
يبدأ مفتاح 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.key-خيارك
تأكد من أن OpenCode يحمّل هذا المتغير البيئي فعليًا. في PowerShell يمكنك تعيين المتغير مؤقتًا للطرفية الحالية:
$env:AI_SCHOOL_CODEREN_API_KEY="ais.key-خيارك"
إذا ظهرت لك Authorization header with Bearer token is required، فسيقوم الأداة بإرسال المفتاح كـ Authorization: Bearer ... فقط. إذا ظهرت لك Unknown parameter، فقم بإزالة الإعدادات الخاصة بمزود الخدمة التي لا تدعمها واجهة Coderen في AI-Public.