یک دروازه OpenCode AI به شما یک لایه API پایدار بین جریان کاری ترمینال شما و مدلهایی که واقعاً میخواهید استفاده کنید، میدهد. اگر با کلیدهای ارائهدهنده جداگانه، صفحات صورتحساب جداگانه و خطرات دسترسی جداگانه سر و کار دارید، آن لایه اضافی میتواند اجرای OpenCode را در روزمره بسیار آسانتر کند.
ShareAI این نقش را به خوبی ایفا میکند زیرا یک API برای بیش از 150 مدل به همراه مسیریابی هوشمند، پشتیبانی از خرابی و دید بازار به شما میدهد. OpenCode از ارائهدهندگان سفارشی سازگار با OpenAI پشتیبانی میکند، بنابراین تنظیمات عمدتاً مربوط به اشاره OpenCode به URL پایه صحیح و افزودن مدلی است که میخواهید استفاده کنید.
این راهنما بخشی از توسعهدهندگان مقالات ما درباره مسیریابی AI، دسترسی به مدلها و یکپارچهسازیهای آماده تولید است.
چرا در وهله اول از یک دروازه OpenCode AI استفاده کنیم؟
OpenCode برای کار با بسیاری از ارائهدهندگان طراحی شده است و مستندات عمومی آن نشاندهنده پشتیبانی از پیکربندی ارائهدهنده سفارشی، baseURL baseURL.
- و نقاط پایانی سازگار با OpenAI است. این انعطافپذیری قدرتمند است، اما همچنین به این معناست که ممکن است هر ارائهدهنده را جداگانه مدیریت کنید، در حالی که واقعاً فقط یک جریان کاری کدنویسی تمیز میخواهید.
- یک کلید API به جای یک کلید برای هر فروشنده مدل.
- یک سطح صورتحساب به جای چندین داشبورد.
- تغییرات تمیز بین مدلها برای ویرایشهای سریع، وظایف با زمینه طولانی یا بازسازیهای سنگینتر.
یک لایه مسیریابی که میتواند کمک کند وقتی یک ارائهدهنده کند، غیرقابل دسترس یا دیگر مناسبترین گزینه برای کار نیست.
برای توسعهدهندگانی که انعطافپذیری بدون نگهداری لولهکشی جداگانه ارائهدهنده میخواهند، معمولاً این نقطهای است که یک دروازه AI شروع به بازپرداخت هزینههای خود میکند.
چگونه OpenCode از این تنظیمات پشتیبانی میکند مستندات ارائهدهنده OpenCode, ، شما میتوانید تنظیمات ارائهدهنده را از طریق opencode.json, ، تنظیم یک baseURL, سفارشی، و استفاده از @ai-sdk/openai-compatible برای ارائهدهندگان سازگار با OpenAI. مخزن عمومی GitHub OpenCode همچنین مسیرهای پیکربندی آن را مستند میکند و تأیید میکند که این ابزار برای انعطافپذیری در سطح ارائهدهنده ساخته شده است.
این بدان معناست که شما نیازی به بسته یکپارچهسازی ویژه ShareAI برای شروع ندارید. شما میتوانید ShareAI را بهعنوان یک ارائهدهنده سفارشی اضافه کنید، کلید API خود را در یک متغیر محیطی نگه دارید، و سپس مدل دقیقی را که میخواهید OpenCode فراخوانی کند انتخاب کنید.
مرحله 1: کلید API ShareAI خود را ایجاد کنید و یک مدل انتخاب کنید
با ایجاد اعتبارنامه در ایجاد کلید API. شروع کنید. سپس مرور کنید بازار مدل ShareAI تا تصمیم بگیرید کدام مدل باید از جریان کاری OpenCode شما پشتیبانی کند.
یک الگوی عملی این است که یک مدل پیشفرض برای وظایف روزمره کدنویسی انتخاب کنید و یک یا دو جایگزین را برای مواردی که میخواهید تأخیر کمتر، هزینه کمتر، یا مدل استدلال قویتر داشته باشید در نظر بگیرید.
مرحله 2: ShareAI را به عنوان یک ارائهدهنده سفارشی در opencode.json اضافه کنید
OpenCode به شما اجازه میدهد یک ارائهدهنده سفارشی با یک نقطه پایانی سازگار با OpenAI تعریف کنید. یک قالب شروع ساده به این شکل است:
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"shareai": {
"npm": "@ai-sdk/openai-compatible",
"name": "ShareAI",
"options": {
"baseURL": "https://api.shareai.now/v1",
"apiKey": "{env:SHAREAI_API_KEY}"
},
"models": {
"your-shareai-model": {
"name": "Choose a ShareAI model"
}
}
}
}
}جایگزین کنید your-shareai-model با شناسه دقیق مدلی که میخواهید از کاتالوگ مدل ShareAI استفاده کنید. کلید API را از خود فایل خارج کنید و به جای آن از طریق یک متغیر محیطی بارگذاری کنید.
export SHAREAI_API_KEY="your_api_key_here"
opencodeاگر فرمت درخواست گستردهتر و جزئیات احراز هویت را میخواهید، مرجع API جریان اصلی API ShareAI را پوشش میدهد.
مرحله 3: تغییر مدلها بدون بازسازی تنظیمات شما
هنگامی که ShareAI لایه ارائهدهنده است، تغییر مدلها بسیار سبکتر میشود. دیگر نیازی به بازسازی احراز هویت فروشنده هر بار که میخواهید یک مدل متفاوت را آزمایش کنید ندارید. در عوض، همان سطح API را حفظ کرده و مدل را که OpenCode به آن اشاره میکند تغییر میدهید.
این به ویژه زمانی مفید است که جریان کاری کدنویسی شما بر اساس وظیفه تغییر کند. ممکن است یک مدل برای ویرایشهای سریع، دیگری برای استدلالهای بزرگتر در مخزن، و سومی به عنوان جایگزین زمانی که هزینه یا تأخیر بیشتر از قابلیت اوج اهمیت دارد، بخواهید. میتوانید گزینهها را در بازار مدل شفاف چند ارائهدهنده و رفتار را بررسی کنید در زمین بازی قبل از اینکه یک پیشفرض را قفل کنید.
زمانی که کلیدهای مستقیم ارائهدهنده هنوز منطقی هستند
هنوز مواردی وجود دارد که رفتن مستقیم منطقی است. اگر به یک ویژگی بتا خاص ارائهدهنده، توافقنامه خصوصی شرکتی، یا تنظیمات سختگیرانه درون ارائهدهنده وابسته هستید، ممکن است بخواهید آن مسیر را جدا نگه دارید.
اما برای تیمهایی که عمدتاً میخواهند OpenCode انعطافپذیر، قابل حمل و آسانتر برای اجرا باقی بماند، استفاده از یک دروازه OpenCode AI اغلب گزینه پیشفرض تمیزتری است. این کار پراکندگی حسابها را کاهش میدهد و به شما اجازه میدهد مدلها را بر اساس عملکرد و تناسب ارزیابی کنید، نه بر اساس اینکه آخرین بار کدام ورود به سیستم فروشنده را تنظیم کردهاید.
نتیجهگیری نهایی
یک دروازه OpenCode AI به معنای افزودن ابزارهای بیشتر به خاطر خود ابزارها نیست. بلکه به معنای حفظ یک جریان کاری کدنویسی است، در حالی که به خودتان امکان تغییر مدلها، مقایسه ارائهدهندگان و ادامه حرکت در زمانی که چشمانداز مدلهای پایه تغییر میکند را میدهید. اگر این چیزی است که از OpenCode میخواهید، ShareAI یک راه عملی برای انجام آن از طریق یک API به شما ارائه میدهد.