قالب چت OpenAI (مسیر /v1/chat/completions با آرایه‌ی messages) به یک استاندارد غیررسمی تبدیل شده است. بسیاری از ارائه‌دهنده‌ها و دروازه‌ها آن را پیاده می‌کنند و در نتیجه ابزارهایی مثل LangChain، Cursor، n8n و Open WebUI فقط با تغییر Base URL و کلید به آن‌ها وصل می‌شوند.
سازگاری درجه دارد: ممکن است چت و استریم کامل باشد ولی بعضی پارامترها یا نقاط (مثل امبدینگ یا Responses API) نباشد. پیش از وابستگی، فهرست نقاط پشتیبانی‌شده را بررسی کنید.
فایده‌ی این استاندارد، پرهیز از قفل‌شدن به یک ارائه‌دهنده است: می‌توانید مدل یا سرویس را با عوض کردن چند مقدار تغییر دهید.
مثال کاربردی
ابزار n8n یا Cursor فقط برای OpenAI نوشته شده، اما فیلد Base URL دارد. چون API مقصد همان قالب را پیاده کرده، ابزار بدون هیچ تغییر دیگری کار میکند و شما می‌توانید مدل را از فهرست مقصد انتخاب کنید.
چطور در عمل بررسی کنیم؟
بهترین راه یادگرفتن این مفهوم، دیدن آن در یک درخواست واقعی است. یک کلید بسازید، فهرست مدل‌ها را با /v1/models بگیرید، یک درخواست کوچک بفرستید و فیلدهای پاسخ (از جمله usage و finish_reason) را بخوانید. سپس همان درخواست را با پارامتر یا مدل دیگر تکرار و در داشبورد مصرف و هزینه را مقایسه کنید. نمونه‌های آماده در راهنمای cURL و راهنمای پایتون هست.
اصطلاحات نزدیک
- آدرس پایه (Base URL): Base URL آدرس ریشه‌ی یک API است که مسیرهای مختلف مثل /chat/completions به آن اضافه می‌شود؛ با تغییر آن می‌توان همان کلاینت را به سرویس دیگری وصل کرد.
- کلید API: کلید API رشته‌ی محرمانه‌ای است که هویت شما را در برابر یک API ثابت میکند و مصرف را به حساب شما نسبت می‌دهد.
- فراخوانی تابع: Function Calling (Tool Use) قابلیتی است که مدل به‌جای متن آزاد، درخواست اجرای یک تابع با آرگومان‌های ساخت‌یافته را برمی‌گرداند تا برنامه‌ی شما آن را اجرا کند.
- استریم: استریم یعنی مدل پاسخ را تکه‌تکه و هم‌زمان با تولید ارسال کند و نیاز نباشد تا پایان تولید منتظر بمانید.
در پیکو هوش
پیکو هوش نقاط chat/completions، images/generations، audio/speech و models را با قالب OpenAI و نقطه‌ی /v1/messages را با قالب Anthropic ارائه میکند. امبدینگ فعلاً نیست.
اشتباهات رایج
- فرض اینکه هر پارامتر OpenAI روی همه‌ی مدل‌ها کار میکند.
- فراموش کردن Responses API که ممکن است در همه‌ی دروازه‌ها نباشد.
پرسش‌های متداول
آیا برای Claude هم قالب OpenAI کار میکند؟
بله، مدلهای کاتالوگ از طریق همین قالب در دسترساند.
آیا Responses API هست؟
پشتیبانی تضمینشده فقط برای نقاط ذکرشده است؛ برای ابزارهایی که Responses را پیشفرض میگیرند، حالت chat را انتخاب کنید.
API سازگار با OpenAI در پیکو هوش چه نقشی دارد؟
پیکو هوش نقاط chat/completions، images/generations، audio/speech و models را با قالب OpenAI و نقطه‌ی /v1/messages را با قالب Anthropic ارائه میکند. امبدینگ فعلاً نیست.
از تعریف تا عمل
ثبت‌نام کنید، یک کلید بسازید و مفهوم را روی مدل واقعی امتحان کنید.