مرجع توسعه‌دهندگان

EFARS API

مفاهیم اتصال

تفاوت پلتفرم، پروتکل، مدل و عملیات را بشناسید.

راهنمای اتصال مشتریان
curl · Python · JavaScript

چهار انتخاب مستقل

مفهوممعنا
پلتفرم EFARSنشانی سرویس، کلید حساب، دسترسی و گزارش مصرف شما.
پروتکلقالب مسیر، هدر، بدنه، پاسخ و رویدادهای جریان؛ OpenAI، Claude یا Gemini.
مدلشناسه موتور انتخابی با قابلیت‌ها، ظرفیت و تعرفه مشخص.
عملیاتمانند تولید متن، Streaming، Responses یا Embeddings؛ وابسته به مدل و دسترسی حساب.

تاریخچه و نقش‌ها

در Chat Completions و Messages، پیام‌های پیشین را در messages ارسال کنید. در Gemini، history در contents است و نقش پاسخ مدل model نام دارد. سرور را محل نگهداری تاریخچه برنامه در نظر بگیرید؛ یک درخواست عادی به‌خودی‌خود گفت‌وگوی بعدی را ذخیره و بازیابی نمی‌کند.

توکن، context و خروجی

توکن واحد پردازش متن است و با تعداد حرف یا کلمه برابر نیست. ظرفیت context مجموع ورودی، تاریخچه و بخش‌های موردنیاز خروجی را محدود می‌کند. سقف خروجی را با توجه به ظرفیت مدل و بودجه تعیین کنید؛ شمارش دقیق و ابعاد هزینه را از پاسخ، گزارش مصرف و تعرفه همان مدل بخوانید.

قالب موفقیت و خطا

پاسخ موفق هر پروتکل متفاوت است. کد HTTP را پیش از خواندن فیلدهای موفقیت بررسی کنید. خطاهای احراز هویت و دسترسی ممکن است قالب مشترک EFARS داشته باشند و با خطای بومی ارائه‌دهنده متفاوت باشند.