مفاهیم اتصال
تفاوت پلتفرم، پروتکل، مدل و عملیات را بشناسید.
چهار انتخاب مستقل
| مفهوم | معنا |
|---|---|
| پلتفرم EFARS | نشانی سرویس، کلید حساب، دسترسی و گزارش مصرف شما. |
| پروتکل | قالب مسیر، هدر، بدنه، پاسخ و رویدادهای جریان؛ OpenAI، Claude یا Gemini. |
| مدل | شناسه موتور انتخابی با قابلیتها، ظرفیت و تعرفه مشخص. |
| عملیات | مانند تولید متن، Streaming، Responses یا Embeddings؛ وابسته به مدل و دسترسی حساب. |
تاریخچه و نقشها
در Chat Completions و Messages، پیامهای پیشین را در messages ارسال کنید. در Gemini، history در contents است و نقش پاسخ مدل model نام دارد. سرور را محل نگهداری تاریخچه برنامه در نظر بگیرید؛ یک درخواست عادی بهخودیخود گفتوگوی بعدی را ذخیره و بازیابی نمیکند.
توکن، context و خروجی
توکن واحد پردازش متن است و با تعداد حرف یا کلمه برابر نیست. ظرفیت context مجموع ورودی، تاریخچه و بخشهای موردنیاز خروجی را محدود میکند. سقف خروجی را با توجه به ظرفیت مدل و بودجه تعیین کنید؛ شمارش دقیق و ابعاد هزینه را از پاسخ، گزارش مصرف و تعرفه همان مدل بخوانید.
قالب موفقیت و خطا
پاسخ موفق هر پروتکل متفاوت است. کد HTTP را پیش از خواندن فیلدهای موفقیت بررسی کنید. خطاهای احراز هویت و دسترسی ممکن است قالب مشترک EFARS داشته باشند و با خطای بومی ارائهدهنده متفاوت باشند.