روی یک محصول نوشته شده «۱۰ میلیون توکن» و روی دیگری «۱۰ دلار اعتبار». آیا هر دو برای یک تعداد پیام کافی‌اند؟ بدون دانستن مدل، طول ورودی و اندازهٔ پاسخ نمی‌توان جواب دقیقی داد. در این راهنما یاد می‌گیریم مصرف توکن API را چطور بخوانیم و پیش از خرید، چه سؤال‌هایی بپرسیم.

توکن API چیست؟

توکن واحد پردازش متن در مدل زبانی است؛ آن را با تعداد پیام، کلمه یا ماه اشتراک یکی نگیرید. برای برآورد عملی، از شمارندهٔ همان سرویس و مدل استفاده کنید. ابزار شمارش توکن Claude می‌تواند ورودی ساختاریافتهٔ درخواست را بررسی کند؛ برآورد پیش از ارسال هم ممکن است با مصرف نهایی تفاوت کوچکی داشته باشد. مستندات رسمی شمارش توکن Claude.

اگر متن فارسی شما هزار کلمه دارد، نمی‌شود با یک نسبت ثابت و همیشگی تعداد توکن آن را تعیین کرد. نشانه‌گذاری، ساختار متن و مدل اهمیت دارند. برای تصمیم خرید، ده درخواست واقعی و غیرمحرمانه از کار خودتان بردارید و مصرف ثبت‌شده را اندازه بگیرید؛ این نمونه از حدس زدن تعداد پیام قابل اتکاتر است.

تفاوت ورودی، خروجی و اعتبار دلاری

عبارتچه چیزی را نشان می‌دهد؟چه چیزی را باید بررسی کنیم؟
توکن ورودیمحتوایی که برای پردازش ارسال می‌شودمتن درخواست، زمینه و تاریخچهٔ ارسالی
توکن خروجیمحتوایی که مدل تولید می‌کندطول پاسخ و محدودیت تولید
اعتبار دلاریبودجهٔ قابل مصرف طبق تعرفهٔ سرویسمدل مجاز، نرخ‌ها و هزینهٔ ابزارها
مدت اعتباربازهٔ زمانی استفاده از بستهتاریخ شروع و انقضای همان پلن

در تعرفهٔ رسمی Claude نرخ ورودی و خروجی جداست و قابلیت‌هایی مثل کش و ابزارها می‌توانند محاسبه را تغییر دهند. بنابراین یک میلیون توکن را بدون مشخص کردن نوع مصرف و مدل به یک مبلغ ثابت تبدیل نکنید. جدول رسمی تعرفه‌ها و هزینه‌های Claude API.

یک مثال برای برنامه‌ریزی مصرف

فرض آموزشی ما این است که هر درخواست ۲۰۰۰ توکن ورودی و ۵۰۰ توکن خروجی دارد. برای ۱۰۰ درخواست، مجموع سادهٔ ورودی ۲۰۰ هزار و خروجی ۵۰ هزار توکن می‌شود. این اعداد قیمت واقعی یا ظرفیت تضمین‌شدهٔ هیچ محصولی نیستند؛ فقط روش محاسبه را نشان می‌دهند.

اگر نرخ هر میلیون توکن ورودی را A و نرخ خروجی را B بنامیم، هزینهٔ پایه در این مثال برابر ۰٫۲ ضرب‌در A به‌اضافهٔ ۰٫۰۵ ضرب‌در B است. هزینه‌های جداگانهٔ سرویس، ابزار یا واسطه را باید طبق قرارداد خودتان اضافه کنید. بستهٔ فروشگاه ممکن است قواعد مصرف متفاوتی داشته باشد؛ مشخصات همان بسته ملاک است.

چطور یک برآورد قابل استفاده بسازیم؟

  1. سه کار پرتکرار را مشخص کنید؛ مثلاً خلاصه‌سازی، پاسخ پشتیبانی و بازنویسی متن.
  2. برای هر کار چند نمونهٔ معمولی و یک نمونهٔ طولانی انتخاب کنید.
  3. مدل، ورودی، خروجی و مصرف ثبت‌شده را در یک جدول یادداشت کنید.
  4. میانگین و نمونهٔ پرمصرف را جدا نگه دارید؛ فقط بهترین حالت را مبنا نگیرید.
  5. تعداد اجرای مورد انتظار را در مصرف نمونه ضرب کنید و برای خطا و اصلاح پاسخ هم بودجه بگذارید.

اگر گفت‌وگویی طولانی شده، بررسی کنید برنامهٔ شما چه مقدار از تاریخچه را در هر درخواست دوباره می‌فرستد. محدود کردن پاسخ غیرضروری و فرستادن بخش مرتبط سند، دو تصمیم کاربردی برای کنترل مصرف‌اند. حذف زمینهٔ لازم صرفاً برای کاهش مصرف ممکن است کیفیت پاسخ را پایین بیاورد.

قبل از خرید اعتبار API چه بپرسیم؟

در صفحهٔ اعتبار API Claude نام پلن و واحد ظرفیت را جدا بخوانید. بپرسید اعتبار به چه مدل‌هایی دسترسی می‌دهد، ورودی و خروجی چگونه حساب می‌شوند، محدودیت درخواست چیست و ظرفیت باقی‌مانده از کجا دیده می‌شود. «۱۰ میلیون توکن» به معنی «۱۰ ماه» نیست؛ مدت باید جدا مشخص شده باشد.

اگر هدف شما گفت‌وگو در سایت اصلی سرویس است، ابتدا مطمئن شوید محصول انتخابی برای همان رابط است. داشتن کلید یا اعتبار API به‌تنهایی به معنی داشتن اشتراک وب نیست. برای آشنایی با انواع دسترسی، راهنمای تفاوت اکانت، کلید API و اشتراک را هم بخوانید.

پرسش‌های متداول

هر پیام چند توکن مصرف می‌کند؟

عدد ثابتی ندارد. طول ورودی، تاریخچهٔ ارسال‌شده و پاسخ روی مصرف اثر دارند؛ اندازه‌گیری نمونه‌های واقعی راه بهتری برای برآورد است.

آیا اعتبار بیشتر یعنی مدت بیشتر؟

خیر. ظرفیت مصرف و تاریخ انقضا دو ویژگی مستقل‌اند و باید هر دو در مشخصات پلن بررسی شوند.

آیا مثال این مقاله قیمت خرید را مشخص می‌کند؟

خیر. مثال صرفاً آموزشی است. قیمت و قواعد مصرف را از صفحهٔ همان پلن و تعرفهٔ معتبر سرویس بخوانید.