کدگذاری با کلیدهای API
با کلید API کدگذاری میتوانید از ابزارهای برنامهنویسی استفاده کنید که با API سازگار با OpenAI کار میکنند. ابزار درخواستها را به AI-School میفرستد. AI-School کلید، بودجه، مدت اعتبار و مدلهای مجاز را بررسی میکند.
سپس AI-School درخواست را از طریق پیوند فنی محیط پردازش میکند.
به چه چیزی نیاز دارید؟
به سه داده نیاز دارید:
| داده | کجا میتوانید آ ن را پیدا کنید؟ |
|---|---|
| کلید API | این کلید را از مدیر یا مدرس دریافت میکنید |
| Endpoint (نقطه پایانی) | https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1 |
| نام مدل | به عنوان مثال gpt-5.4-mini، gpt-5.4 یا gpt-5.5 |
کلید API با ais. آغاز میشود. به این کلید به عنوان رمز عبور رفتار کنید.
کدام مدل را انتخاب میکنید؟
برای اکثر دانشآموزان، GPT-5.4 mini بهترین نقطه شروع است. این مدل ارزانتر است و برای کمکی در برنامهنویسی در کلاس مناسب است.
برای مدرسین یا دانشآموزان پیشرفتهتر، GPT-5.4 یا GPT-5.5 ممکن است مناسبتر باشد، مثلاً در پروژههای بزرگتر یا کد پیچیدهتر.
کدام ابزار را انتخاب میکنید؟
AI-School دو ابزار پیشنهاد میدهد:
| ابزار | مناسب برای | دلیل |
|---|---|---|
| Aider | دانشآموزان و کدنویسی به صورت کلاس | بهطور صریح کار میکند، روشن است و کمتر جهتگیری عامل دارد |
| OpenCode | مدرسین و کاربران پیشرفته | ابزار CLI عاملمند همراه با یک اپ دسکتاپ |
Aider برای دانشآموزان
Aider مانند یک ابزار جفت-برنامهنویسی در ترمینال عمل میکند. کاربر برای کمک درخواست میدهد، تغییرات را میبیند و نسبتاً به کد نزدیک میماند. این با یادگیری برنامهنویسی سازگار است: دانشآموز پشتیبانی میبیند اما خود نیز درگیر اتفاقاتی که میافتد میماند.
به مستندات رسمی Aider نیز مراجعه کنید: officiële Aider-documentatie.
OpenCode برای استفاده پیشرفته
OpenCode بیشتر عاملمند است. ابزار میتواند بهطور مستقل گامها را انجام دهد، فایلها را ویرایش کند و کارها را گسترش دهد. این قدرتمند است، اما نیاز به درک بیشتر کد، گیت و محیطهای توسعه محلی دارد.
به مستندات رسمی OpenCode نیز مراجعه کنید: officiële OpenCode-documentatie.
ایمنی کار با کلیدها
کلید API خود را به صورت عمومی منتشر نکنید و در کدی که به اشتراک میگذارید قرار ندهید.
ترجیحاً از موارد زیر استفاده کنید:
- متغیرهای محیطی
- یک فایل
.envمحلی که به گیت ارسال نمیشود - پیکربندی داخلی ابزار
برای OpenCode میتوانید به عنوان مثال از یک .env در پوشه پروژه استفاده کنید:
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 از آن پشتیبانی نمیکند
در صورت تردید از مدیر یا مدرس بخواهید کلید را بررسی کنند.