رمزگذاری با کلیدهای API
با کلید Coderen API، میتوانید ابزارهای برنامهنویسی استفاده کنید که با یک API سازگار با OpenAI کار میکند. ابزار درخواستها را به AI-School ارسال میکند. AI-School کلید، بودجه، دوره اعتبار و مدلهای مجاز را بررسی میکند.
سپس AI-School درخواست را از طریق اتصال فنی محیط پردازش میکند.
به چه چیزی نیاز دارید؟
به سه داده نیاز دارید:
| داده | کجا پیدا میکنید؟ |
|---|---|
| کلید API | این را از مدیر یا مدرس دریافت میکنید |
| Endpoint | 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 برای پروژههای بزرگتر و کد پیچیده مناسب است. برای وظایف بسیار demanding که نیاز به تحلیل، برنامهریزی یا استدلال دارد، GPT-5.6 Sol را انتخاب کنید.
کدام ابزار را انتخاب کنید؟
AI-School دو ابزار پیشنهاد میکند:
| ابزار | مناسب برای | چرا |
|---|---|---|
| Aider | دانشآموزان و کدنویسی کلاس | کار میکند به صورت صریح، واضح و کمتر عاملانگیز |
| OpenCode | مدرسین و کاربران پیشرفته | ابزار CLI با عاملانگیز نیز یک برنامه دسکتاپ دارد |
Aider برای دانشآموزان
Aider مانند ابزار جفت-برنامهنویسی در ترمینال کار میکند. کاربر درخواست کمک میکند، تغییرات را میبیند و نسبتاً نزدیک به کد باقی میماند. این برای یادگیری برنامهنویسی مناسب است: دانشآموز پشتیبانی را دریافت میکند اما خود درگیر آنچه اتفاق میافتد میماند.
به مستندات رسمی Aider نیز مراجعه کنید: officiële Aider-documentatie.
OpenCode برای استفاده پیشرفته
OpenCode بیشتر به سمت عاملانگیز بودن میرود. ابزار میتواند گامها را بهطور مستقل انجام دهد، فایلها را ویرایش کند و وظایف را گسترش دهد. این قدرتمند است، اما نیاز به درک بیشتر از کد، گیت و محیطهای توسعه محلی دارد.
به مستندات رسمی OpenCode نیز مراجعه کنید: officiële OpenCode-documentatie.
ایمنی استفاده از کلیدها
کلید API را به صورت عمومی منتشر نکنید و در کدی که به اشتراک میگذارید، قرار ندهید.
بهتر است از:
- متغیرهای محیطی
- یک فایل
.envمحلی که به گیت ارسال نشود - پیکربندی داخلی ابزار استفاده شود
برای OpenCode میتوانید از مثال زیر در پوشه پروژه استفاده کنید:
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 پشتیبانی نمیکند، همراه میآورد
اگر شک دارید از مدیر یا مدرس درخواست کنید کلید را بررسی کند.
