توکن‌ها چگونه شمرده می‌شوند

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

توکن‌ها واحد اندازه‌گیری کار در Claude (و هر LLM دیگری) هستند. تقریباً 4 نویسهٔ متن انگلیسی — و تقریباً چیزی که بابتش پول می‌دهید.

همهٔ مدل‌ها، قابلیت‌ها و قیمت‌ها فهرست مستندات برای عامل‌های هوش مصنوعی: https://oneprovider.dev/docs/llms.txt

قاعدهٔ سرانگشتی

1 توکن ≈ 4 نویسهٔ انگلیسی ≈ 0.75 کلمه.
یک صفحه متن نثر (حدود 500 کلمه) حدود 670 توکن است.
کد منبع، خط‌های غیر لاتین و ایموجی فشرده‌تر توکنایز می‌شوند — 1.2 تا 2 برابر نرخ انگلیسی را انتظار داشته باشید.
یک پنجرهٔ زمینهٔ 200k توکنی تقریباً 150k کلمهٔ انگلیسی است — حدود 300 صفحه.

چهار نوع توکن در صورت‌حساب شما

داده‌های مرجع

نوع	چیست	چگونه محاسبه می‌شود
Input	هر توکنی که مدل می‌خواند: پرامپت سیستم، نوبت‌های قبلی، پیام فعلی کاربر، schema ابزارها، تصاویر.	نرخ کامل ورودی.
Output	هر توکنی که مدل می‌نویسد: متن پاسخ، فراخوانی ابزارها، تفکر (اگر فعال باشد).	نرخ کامل خروجی (معمولاً 5 برابر ورودی).
Cache read	توکن‌های ورودی که از نقطهٔ کش یک درخواست قبلی تأمین می‌شوند.	10% نرخ ورودی برای بیشتر مدل‌ها؛ نرخ دقیق هر مدل در جدول مدل‌ها است.
Cache write	اولین درخواست در یک نقطهٔ کش — کش را برای خواندن‌های بعدی می‌سازد.	125% نرخ ورودی برای بیشتر مدل‌ها؛ نرخ دقیق هر مدل در جدول مدل‌ها است.

هر پاسخ این شمارش‌ها را در فیلد usage دارد — به مصرف و صورت‌حساب نگاه کنید.

برآورد پیش از ارسال

SDKهای Anthropic یک تابع کمکی شمارش توکن دارند که می‌توانید محلی اجرا کنید:

python

from anthropic import Anthropic
client = Anthropic(base_url="https://api.oneprovider.dev")
count = client.messages.count_tokens(
model="claude-sonnet-5-5",
messages=[{"role": "user", "content": "Your long prompt here"}],
)
print(count.input_tokens)

این شمارش یک کران پایین است — خروجی‌ای را که مدل قرار است بنویسد شامل نمی‌شود. برای بودجه‌بندی، سقف max_tokens را بگذارید و بدترین حالت را فرض کنید.

صرفه‌جویی کش را چگونه برآورد کنیم

ضریب همگانی برای همهٔ مدل‌ها وجود ندارد. برای مدل متعادل فعلی claude-sonnet-5-5 یا هر مدل دیگر، مقادیر جداگانهٔ خواندن از کش (Cache read) و نوشتن در کش (Cache write) آن را از جدول نرخ‌ها بردارید. آن‌ها را با نرخ ورودی مدل انتخابی و تعداد خواندن‌های تکراری مورد انتظار مقایسه کنید.

قیمت یک درخواست بالای صفحهٔ /pricing یک درخواست نمونه را خط به خط قیمت‌گذاری می‌کند: ورودی، خواندن از کش و خروجی با نرخ هر مدل — همان اعداد جدول نرخ‌ها .

پاسخ‌های سریع

از کدام base URL استفاده کنم؟

Claude Code و SDKهای Anthropic از https://api.oneprovider.dev استفاده می‌کنند. SDKهای OpenAI و کلاینت‌های سازگار با OpenAI از https://api.oneprovider.dev/v1 استفاده می‌کنند. یک کلید پشت هر دو آدرس کار می‌کند؛ فهرست مدل‌ها در صفحهٔ مدل‌ها و نرخ‌ها در صفحهٔ قیمت‌ها است.

چگونه احراز هویت کنم؟

کلید خام sk-… را در x-api-key یا Authorization: Bearer بفرستید: یکی از این دو، نه هر دو. کلید را در یک متغیر محیطی نگه دارید، نه در فایلی که commit می‌شود. اطلاعات بیشتر دربارهٔ احراز هویت .

کلید را از کجا بگیرم؟

حساب کاربری خود را در ربات Telegram به نام @oneprovider_robot یا در app.oneprovider.dev باز کنید، موجودی را شارژ کنید و «صدور کلید» را بزنید. هر کلید می‌تواند سقف مصرف مخصوص خودش را داشته باشد. حساب کاربری و کلیدهای API .

کدهای 401، 404 و 429 یعنی چه؟

401: کلید ارسال نشده، اشتباه تایپ شده یا در هدر نادرست فرستاده شده است؛ کلید را کامل و بدون گیومه و فاصله جای‌گذاری کنید. 404: معمولاً base URL نادرست است، مثلاً /v1 جا افتاده یا دوبار آمده است. 429 با پیام «Insufficient balance»: موجودی حساب کاربری یا سقف مصرف کلید تمام شده است؛ به‌جای تلاش دوباره، شارژ کنید. هر 429 دیگری محدودیت نرخ است؛ تا پایان زمان Retry-After صبر کنید. جزئیات: کدهای خطا و رفع اشکال .

چرا استریم‌ها قطع یا ریست می‌شوند؟

VPN و پروکسی‌های VLESS اغلب SSE را بافر می‌کنند یا مذاکرهٔ HTTP/2 را مختل می‌کنند. OneProvider هیچ محدودیت منطقه‌ای ندارد و استریم‌ها را بافر نمی‌کند؛ پروکسی را خاموش کنید و دوباره امتحان کنید.

اگر این‌ها کافی نبود از کجا بپرسم؟

در Telegram به @Oneproviderhelpbot پیام بدهید یا در حساب کاربری وب «پشتیبانی» را باز کنید و کد وضعیت HTTP و متن دقیق خطا را بفرستید. پشتیبانی چگونه کار می‌کند .

آخرین به‌روزرسانی: 2026-11-08 باگی پیدا کردید؟ @Oneproviderhelpbot