کدگذاری با کلیدهای 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 از آن پشتیبانی نمی‌کند

در صورت تردید از مدیر یا مدرس بخواهید کلید را بررسی کنند.