
استفاده از API هوش مصنوعی در C# و .NET با کتابخانهٔ رسمی OpenAI
راهنمای عملی کتابخانهٔ رسمی OpenAI برای .NET با API هیبانا؛ نصب، چت، گفتوگوی چندمرحلهای، استریم، مدیریت خطا و ASP.NET Core با کد آزمودهشده.
۵ دقیقه مطالعه
توکن در مدلهای زبانی یعنی چه، قیمت «هر یک میلیون توکن» را چطور بخوانیم و چرا هزینهٔ چتباتها زود بالا میرود؛ با یک مثال عددی و راههای کم کردن هزینه.

«به ازای هر 1M یعنی چه؟» یکی از پرتکرارترین سؤالهایی است که از ما پرسیده میشود. این مطلب با یک مثال ساده نشان میدهد هزینهٔ هر درخواست دقیقاً چطور حساب میشود.
مدلهای زبانی متن را کلمه به کلمه نمیخوانند؛ آن را به تکههای کوچکی به نام توکن میشکنند. یک توکن ممکن است یک کلمهٔ کوتاه، بخشی از یک کلمهٔ بلند یا یک علامت نگارشی باشد.
دو نکته که بیشتر کاربران نمیدانند:
هر درخواست دو بخش دارد:
قیمت هر مدل برای «هر یک میلیون توکن» ورودی و خروجی جداگانه اعلام میشود و خروجی تقریباً همیشه گرانتر است. فرمول کامل در صفحهٔ قیمتگذاری مستندات آمده است:
هزینه = (توکن ورودی ÷ 1,000,000) × قیمت ورودی + (توکن خروجی ÷ 1,000,000) × قیمت خروجیفرض کنید قیمت مدلی (عدد فرضی) این باشد:
| قیمت هر یک میلیون توکن | |
|---|---|
| ورودی | ۱۵۰٬۰۰۰ تومان |
| خروجی | ۶۰۰٬۰۰۰ تومان |
و درخواست شما ۲٬۰۰۰ توکن ورودی و ۵۰۰ توکن خروجی داشته باشد:
یعنی کل این درخواست ۶۰۰ تومان هزینه دارد. قیمت واقعی هر مدل را در لیست مدلها ببینید.
API مدلها «حافظه» ندارد: برای اینکه مدل گفتوگوی قبلی را بداند، باید کل تاریخچه را در هر درخواست دوباره بفرستید. پیام دهم یک گفتوگو، نُه پیام قبلی را هم با خودش میبرد و هر بار توکن ورودی بیشتری مصرف میشود.

ابزارهایی مثل Cline هم در هر درخواست یک پرامپت سیستمی بزرگ میفرستند؛ توضیحش را در مقایسهٔ ایجنتهای کدنویسی نوشتهایم.
max_tokens سقف طول پاسخ را تعیین میکند.هزینهٔ API هوش مصنوعی ساده است: تعداد توکن ضرب در قیمت. چیزی که آن را گران میکند معمولاً تکرار تاریخچه و پرامپتهای بزرگ است، نه خود سؤالها. با انتخاب مدل مناسب و کنترل طول ورودی و خروجی، همان کار را با هزینهٔ خیلی کمتر انجام میدهید.

راهنمای عملی کتابخانهٔ رسمی OpenAI برای .NET با API هیبانا؛ نصب، چت، گفتوگوی چندمرحلهای، استریم، مدیریت خطا و ASP.NET Core با کد آزمودهشده.
۵ دقیقه مطالعه

راهنمای قدمبهقدم استفاده از کتابخانهٔ رسمی openai در Node.js با API هیبانا؛ نصب، متغیر محیطی، چت، استریم و مدیریت خطا با کد آزمودهشده.
۵ دقیقه مطالعه

هر کد خطای API هیبانا یعنی چه و چه باید کرد؛ از ۴۰۱ و ۴۰۲ تا ۴۲۹ و ۵۰۰، با کد پایتون آزمودهشده برای مدیریت خطا، تلاش مجدد و بررسی موجودی.
۶ دقیقه مطالعه
GPT، Claude، Gemini و دهها مدل دیگر، با پرداخت ریالی و یک API سازگار با OpenAI.