«OpenAI uyumlu» (OpenAI-compatible), bir hizmetin tam olarak OpenAI'nin Chat Completions istek ve yanıt biçimini uyguladığı anlamına gelir — aynı alanlar, aynı JSON yapısı, Authorization: Bearer başlığıyla aynı kimlik doğrulama yöntemi. Bu sözleşme üretken yapay zeka pazarının ilk ve en yaygın standardı haline geldiğinden, bugün çoğu SDK, kütüphane ve açık kaynak araç bu format üzerine inşa edilmektedir — yalnızca OpenAI iyi olduğu için değil, herkesin ortak bir dil üzerinde anlaştığı için.
Bu, geliştirici için ne anlama geliyor?
Yani bu sözleşme için bir kez yazdığınız kod, yalnızca iki şeyi değiştirerek — temel adres (base URL) ve API anahtarı — aynı sözleşmeyi uygulayan herhangi bir serviste uygulama mantığını değiştirmeden çalışır. Kodunuz belirli bir sağlayıcıya kilitlenmez.
Bu kalıbın gerçek bir örneği nerede?
OpenRouter — Abrak yapay zeka uygulamasının arkasındaki sağlayıcılardan biri — yüzlerce farklı modele erişim için tam olarak bu kalıbı uygulamıştır: sabit bir sözleşme, arkasında çeşitli modeller.
Bu, Abrak'ta nasıl kullanılıyor?
/ai/v1/chat/completions bağlantı noktası Abrak Yapay Zeka uygulaması Tam olarak aynı sözleşmeyi uygular. Yani bugün OpenAI ile çalışan her kod — bir Python betiği, bir n8n otomasyonu, bir dahili bot — yalnızca temel adresi ve anahtarı değiştirerek ( AI Cüzdanım verilir), Abrak'ın Riyal cüzdanında da çalışır; yeniden yazım gerekmez, yabancı banka kartı gerekmez.
Bir kısıtlaması var mı?
Yalnızca Chat Completions sözleşmesinin kapsadığı özellikler kullanılabilir (konuşmaya dayalı metin üretimi); bu standart sözleşmenin dışındaki belirli sağlayıcıya özgü özellikler her yerde aynı şekilde erişilebilir olmayabilir. Çoğu iş uygulaması için — yazma, özetleme, yanıt verme — bu herhangi bir kısıtlama oluşturmaz.
Modelleri görmek ve başlamak için: Abrak yapay zeka ve cüzdan sayfası.
نگاشت درخواست‌ها؛ چه چیزی عوض می‌شود و چه چیزی نه
«سازگار با OpenAI» یعنی مسیر و شکل درخواست یکسان است، نه اینکه همهٔ قابلیت‌ها یکسان‌اند. در عمل فقط دو چیز عوض می‌شود: آدرس پایه و کلید.
| بخش | در سرویس اصلی | در سرویس سازگار | نیاز به تغییر کد |
|---|---|---|---|
| آدرس پایه (base URL) | دامنهٔ ارائه‌دهنده | دامنهٔ سرویس داخلی | یک خط تنظیمات |
| کلید احراز هویت | کلید ارائه‌دهنده | کلید سرویس داخلی | یک متغیر محیطی |
| مسیر تکمیل گفتگو | /v1/chat/completions | همان مسیر | ندارد |
| نام مدل | شناسهٔ مدل ارائه‌دهنده | شناسهٔ مدل میزبانی‌شده | یک رشته |
| پاسخ جریانی (streaming) | پشتیبانی | معمولاً پشتیبانی | ندارد |
| قابلیت‌های اختصاصی ارائه‌دهنده | موجود | ممکن است نباشد | باید بررسی شود |
سه چیزی که پیش از مهاجرت باید تست کنید
- فراخوانی ابزار (tool/function calling): رایج‌ترین جایی که سازگاری ناقص است؛ اگر برنامه‌تان به آن تکیه دارد، اول همین را امتحان کنید.
- پنجرهٔ متن و محدودیت توکن: مدل میزبانی‌شده ممکن است پنجرهٔ کوچک‌تری داشته باشد و درخواست‌های بلند شما را رد کند.
- رفتار در خطا و محدودیت نرخ: کد وضعیت و ساختار خطا را بررسی کنید تا منطق تلاش مجدد برنامه سالم بماند.
الگوی مشابه در سمت ابزارها با MCP پیاده می‌شود؛ تفاوت این دو رویکرد در MCP یا API سنتی آمده است. برای دسترسی ریالی به مدل‌ها بدون کارت خارجی هم راهنمای دسترسی به GPT، Claude و Gemini و صفحهٔ هوش مصنوعی ابرک را ببینید.
