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

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

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

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

سه داده لازم است:

داده	کجا پیدا می‌کنید؟
کلید API	این کلید را از یک مدیر دریافت می‌کنید
Endpoint (درگاه)	https://europe-west1-ai-public-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1
نام مدل	به عنوان مثال gpt-5.6-luna, gpt-5.6-terra یا gpt-5.6-sol

کلید API با aip. آغاز می‌شود. این کلید را مانند یک رمز عبور تصور کنید.

کدام ابزار را انتخاب می‌کنید؟

AI-Public برای اکثر کاربران OpenCode را پیشنهاد می‌کند. OpenCode یک ابزار کدنویسی مبتنی بر عامل برای ترمینال، دسکتاپ و IDE است. این ابزار می‌تواند مراحل را به صورت مستقل انجام دهد، فایل‌ها را ویرایش کند و وظایف را بیشتر گسترش دهد.

Aider از نظر فنی با یک نقطه پایانی سازگار با OpenAI سازگار است، اما در محیط‌های Public به عنوان ابزار استاندارد توصیه نمی‌شود.

همچنین به مستندات رسمی OpenCode مراجعه کنید.

رفتار امن با کلیدها

کلید API خود را عمومی به اشتراک نگذارید و آن را در کدی که به اشتراک می‌گذارید قرار ندهید.

ترجیحاً از ابزارهای زیر استفاده کنید:

• متغیرهای محیطی
• یک فایل .env محلی که به گیـت ارسال نمی‌شود
• پیکربندی داخلی ابزار

هشدار

هرگز کلیدهای API را در یک مخزن عمومی، چت، سند مشترک یا اسکرین‌شات قرار ندهید.

اگر کلید کار نکرد

سپس بررسی کنید:

• آیا Coderen برای محیط فعال است
• آیا کلید شما فعال است
• آیا بودجه به پایان رسیده است
• آیا کلید در بازه اعتبار تعیین‌شده قرار دارد
• آیا مدل مجاز استفاده شده است
• آیا endpoint به درستی پیکربندی شده است

اگر شک دارید، از مدیر بخواهید کلید را بررسی کند.

متغیرهای محیطی و OpenCode

برای OpenCode می‌توانید کلید API Coderen را در یک فایل محلی .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 به AI-Public پشتیبانی نمی‌کند را حذف کنید.