رمزگذاری با کلیدهای API
با یک کلید API برای Coderen میتوانید ابزارهای کدنویسی را استفاده کنید که با API سازگار با OpenAI کار میکنند. ابزار درخواستها را به AI-Corporate ارسال میکند. AI-Corporate کلید، بودجه، دوره اعتبار و مدلهای مجاز را بررسی میکند.
سپس درخواست را از طریق اتصال فنی محیط پردازش میکند.
به چه چیزی نیاز دارید؟
به سه داده نیاز دارید:
| داده | کجا پیدا میکنید؟ |
|---|---|
| کلید API | این کلید را از مدیر دریافت میکنید |
| Endpoint | https://europe-west1-ai-corporate.cloudfunctions.net/coderenOpenAiCompatibleApi/v1 |
| نام مدل | مثلاً gpt-5.6-luna, gpt-5.6-terra یا gpt-5.6-sol |
کلید API با aic. آغاز میشود. این کلید را مانند رمز عبور نگهداری کنید.
کدام ابزار را انتخاب میکنید؟
AI-Corporate به اکثر کاربران پیشنهاد میکند OpenCode را استفاده کنند. OpenCode یک ابزار کدنویسی هوشمند برای ترمینال، دسکتاپ و IDE است. این ابزار میتواند گام به گام به صورت مستقل اجرا کند، فایلها را ویرایش کند و کارهای بیشتری انجام دهد.
Aider از نظر فنی با یک نقطه پایان سازگار با OpenAI سازگار است، اما در محیطهای Corporate به عنوان ابزار استاندارد توصیه نمیشود.
همچنین به مستندات رسمی OpenCode مراجعه کنید.
نحوه ایمن کار با کلیدها
کلید API خود را عمومی به اشتراک نگذارید و در کدی که به اشتراک میگذارید استفاده نکنید.
بهتر است از:
- متغیرهای محیطی استفاده کنید
- یک فایل محلی
.envکه به گیت فرستاده نشود - پیکربندی داخلی ابزار را استفاده کنید
هرگز کلیدهای API را در یک مخزن عمومی، چت، سند به اشتراک گذاشتهشده یا اسنپشات قرار ندهید.
اگر کلید کار نمیکند
سپس بررسی کنید:
- آیا Coderen برای محیط فعال است
- آیا کلید شما هنوز فعال است
- آیا بودجه تمام شده است
- آیا کلید در محدوده زمان معتبر است
- آیا از مدل مجاز استفاده میکنید
- آیا endpoint به درستی تنظیم شده است
اگر تردید داشتید، از یک مدیر بخواهید کلید را بررسی کند.
متغیرهای محیطی و OpenCode
برای OpenCode میتوانید کلید Coderen API را در یک فایل محلی .env در پوشه پروژه ذخیره کنید:
AI_SCHOOL_CODEREN_API_KEY=ais.api-کلید-شما
اطمینان حاصل کنید که OpenCode این متغیر محیطی را واقعاً بارگذاری میکند. در PowerShell میتوانید متغیر را موقتی برای ترمینال فعلی تعیین کنید:
$env:AI_SCHOOL_CODEREN_API_KEY="ais.api-کلید-شما"
اگر پیغام Authorization header with Bearer token is required دیدید، ابزار کلید را به عنوان Authorization: Bearer ... همراه خطر نمیدهد. اگر پیغام Unknown parameter دیدید، تنظیمات مخصوص ارائهدهنده که پیکربندی Coderen endpoint AI-Corporate را پشتیبانی نمیکند را حذف کنید.