رمزگذاری با کلیدهای API

با یک کلید API رمزگذاری می‌توانید ابزارهای کدنویسی که با API سازگار با OpenAI کار می‌کنند استفاده کنید. ابزار درخواست‌ها را به AI-Corporate ارسال می‌کند. AI-Corporate کلید، بودجه، دوره اعتبار و مدل‌های مجاز را بررسی می‌کند.

سپس AI-Corporate درخواست را از طریق رابط فنی محیط پردازش می‌کند.

به چه چیزی نیاز دارید؟

به سه داده نیاز دارید:

داده	کجا این را پیدا می‌کنید؟
کلید API	این را از مدیر سیستم دریافت می‌کنید
Endpoint	https://europe-west1-ai-corporate.cloudfunctions.net/coderenOpenAiCompatibleApi/v1
نام مدل	به عنوان مثال gpt-5.4-mini، gpt-5.4 یا gpt-5.5

کلید 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.jouw-api-sleutel

اطمینان حاصل کنید که OpenCode این متغیر محیطی را واقعاً بارگذاری کند. در PowerShell می‌توانید این متغیر را موقتاً برای ترمینال فعلی تنظیم کنید:

$env:AI_SCHOOL_CODEREN_API_KEY="ais.jouw-api-sleutel"

اگر پاسخ “Authorization header with Bearer token is required” را می‌بینید، ابزار کلید را به‌عنوان Authorization: Bearer ... ارسال نمی‌کند. اگر با پاسخ “Unknown parameter” مواجه شدید، تنظیمات مشخص‌کننده ارائه‌دهنده را که توسط endpoint Coderen AI-Corporate پشتیبانی نمی‌شود، حذف کنید.