«سازگار با OpenAI» (OpenAI-compatible) یعنی یک سرویس دقیقاً همان قالب درخواست و پاسخ Chat Completions شرکت OpenAI را پیاده میکند — همان فیلدها، همان ساختار JSON، همان روش احراز هویت با هدر Authorization: Bearer. چون این قرارداد اولین و پرکاربردترین استاندارد بازار هوش مصنوعی مولد شد، امروز اکثر SDKها، کتابخانهها و ابزارهای متنباز روی همین قالب ساخته میشوند — نه چون فقط OpenAI خوب است، بلکه چون همه روی یک زبان مشترک توافق کردهاند.
این برای توسعهدهنده یعنی چه؟
یعنی کدی که یکبار برای این قرارداد نوشتهاید، با تغییر فقط دو چیز — آدرس پایه (base URL) و کلید API — روی هر سرویس دیگری که همین قرارداد را پیاده کرده، بدون تغییر منطق برنامه اجرا میشود. کدتان به یک ارائهدهندهی خاص قفل نمیشود.
نمونهی واقعی این الگو کجاست؟
OpenRouter — یکی از ارائهدهندههای پشت اپ هوش مصنوعی ابرک — دقیقاً همین الگو را برای دسترسی به صدها مدل مختلف پیاده کرده است: یک قرارداد ثابت، مدلهای متنوع پشت آن.
این چطور در ابرک استفاده میشود؟
نقطهی اتصال /ai/v1/chat/completions در اپ هوش مصنوعی ابرک دقیقاً همین قرارداد را پیاده میکند. یعنی هر کدی که امروز با OpenAI کار میکند — یک اسکریپت پایتون، یک اتوماسیون n8n، یک ربات داخلی — با تغییر آدرس پایه و کلید (که از کیفپول AI من صادر میشود)، روی کیفپول ریالی ابرک هم کار میکند؛ بدون بازنویسی، بدون کارت بانکی خارجی.
محدودیتی هم دارد؟
فقط قابلیتهایی که خودِ قرارداد Chat Completions پوشش میدهد قابلاستفادهاند (تولید متن بر اساس مکالمه)؛ ویژگیهای خیلی اختصاصی یک ارائهدهنده که خارج از این قرارداد استاندارد است، ممکن است در همهجا یکسان در دسترس نباشد. برای اکثر کاربردهای کسبوکاری — نگارش، خلاصهسازی، پاسخگویی — این محدودیتی ایجاد نمیکند.
برای دیدن مدلها و شروع: صفحهی هوش مصنوعی و کیفپول ابرک.
چرا «سازگار با OpenAI» شد استاندارد د facto؟
فرمت API چت OpenAI (پیامهای system/user/assistant + پاسخ JSON) آنقدر رایج شد که تقریباً همه ارائهدهندگان مدل — از Groq و DeepSeek تا مدلهای داخلی — همین قرارداد را پیاده کردند. نتیجه: یک بار کلاینت بنویسید، با تغییر یک URL و کلید بین دهها مدل جابهجا شوید.
چه چیزی برای توسعهدهنده ایرانی مهم میکند؟
- بدون تحریم پرداخت: سرویسهای سازگارِ قابل خرید ریالی جایگزین مستقیم میشوند بدون تغییر کد
- جابهجایی ضد ریسک: اگر مدلی کند/گران/قطع شد، متغیر محیطی عوض میکنید نه معماری
- استاندارد ابزارها: SDKها و آموزشهای جامعه حول همین قالب است
در ابرک چطور استفاده میشود؟
دروازه AI ابرک یک endpoint سازگار با OpenAI داخل ERP شما میسازد: ماژولها (چت فروش، گزارشساز، ایجنت) از این endpoint میخوانند و مدیر تعیین میکند هر ماژول به کدام مدل و با چه بودجه توکنی وصل شود. نتیجه: تغییر مدل = تغییر یک ردیف تنظیمات؛ لاگ و سقف هزینه هم سراسری کنترل میشود.
دو سوال پرتکرار
embedding و function-calling هم پشتیبانی میشود؟
بسته به مدل انتخابی؛ دروازه فقط قرارداد را یکسان میکند، قابلیتها از مدل میآید.
داده مشتریان به مدل خارجی میرود؟
در سطح دروازه سیاستگذاری کنید: مسیر مدل داخلی برای داده حساس، خارجی برای عمومی.
