صورتحساب Claude API: هزینه هر مدل در 2026
Updated 2026-07-15
Claude به ازای هر token صورتحساب میکند، با نرخهای جداگانه برای input و output و قیمتی متفاوت برای هر tier مدل. در لیست رسمی 2026 این محدوده از $1 ورودی / $5 خروجی به ازای هر میلیون token روی Haiku 4.5 تا $5 ورودی / $25 خروجی روی Opus 4.7 است.
پاسخ سریع: صورتحساب Claude چطور کار میکند
صورتحساب Claude API پیشپرداخت و به ازای هر token است. شما اعتبار را در Anthropic Console بارگذاری میکنید و هر درخواست tokenهای input (هر چیزی که ارسال میکنید: system prompt، تاریخچه مکالمه، تعریف ابزارها) را با یک نرخ و tokenهای output (هر چیزی که مدل پس مینویسد، شامل thinking tokenها در درخواستهای extended-thinking) را با نرخ بالاتر کسر میکند. هر tier مدل جفت نرخ خودش را دارد، پس همان درخواست روی Opus 4.7 پنج برابر بیشتر از Haiku 4.5 هزینه دارد. سه مکانیزم بیشتر افراد را غافلگیر میکند. اول، output در هر tier فعلی Claude پنج برابر قیمت input است، پس پاسخهای طولانی بر حجم کارهای با input کوچک غالب میشوند. دوم، چت بدون state است: هر turn کل تاریخچه را بهعنوان input دوباره ارسال میکند، پس هزینه هر پیام با طولانیتر شدن مکالمه رشد میکند. سوم، prompt caching و Batch API ویژگیهای صورتحساب هستند، نه فقط ویژگیهای کارایی، و استفاده از آنها آنچه را به ازای هر token میپردازید تغییر میدهد. باقی این صفحه قیمتهای دقیق هر مدل، نحوه تخمین یک درخواست قبل از ارسال، محاسبات caching و اهرمهایی که واقعاً صورتحساب Claude را کاهش میدهند را پوشش میدهد.
جدول قیمت Claude: لیست رسمی در برابر gateway
اینها قیمتهای فعلی به دلار آمریکا به ازای هر میلیون token برای سه tier فعال Claude هستند. ستون official همان چیزی است که Anthropic از طریق Console خود صورتحساب میکند؛ ستون gateway هزینه همان مدلها از طریق APIsRouter است، یک gateway سازگار با OpenAI که مدلهای global را 20% پایینتر از قیمت رسمی فهرست میکند، اولین شارژ شما را با یک bonus 100 درصدی موجودی دو برابر میکند و دسترسی را pay-as-you-go و بدون اشتراک میفروشد (پرداخت در /topup، کلید از طریق ایمیل میرسد). از هر مسیری که صورتحساب میشوید، شمارش یکسان است: همان درخواست همان تعداد token را مصرف میکند و model IDها (claude-opus-4-7، claude-sonnet-4-6) در هر فراخوانی صریح میمانند.
| مدل | رسمی (input / output به ازای 1M) | از طریق APIsRouter (input / output به ازای 1M) |
|---|---|---|
| Claude Opus 4.7 | $5.00 / $25.00 | $4.00 / $20.00 |
| Claude Sonnet 4.6 | $3.00 / $15.00 | $2.40 / $12.00 |
| Claude Haiku 4.5 | $1.00 / $5.00 | $0.80 / $4.00 |
قبل از ارسال یک درخواست، آن را تخمین بزنید
یک token تقریباً چهار کاراکتر یا سهچهارم یک کلمه انگلیسی است، پس 1,000 کلمه prompt حدود 1,300 token است. برای تخمین یک درخواست، هر چیزی در input (system prompt، تاریخچه، پیام جدید کاربر) را جمع بزنید و طول پاسخ را حدس بزنید. مثال محاسبهشده روی Sonnet 4.6 با نرخهای رسمی: یک turn چت با system prompt 1,500 token، 5,500 token تاریخچه انباشتهشده و پاسخ 500 token. input برابر 7,500 token است که هزینهاش 7,500 / 1,000,000 x $3.00 = $0.0225 میشود. output برابر 500 token با $15.00 به ازای هر میلیون است که $0.0075 میشود. مجموع: $0.03 برای آن turn. با 300 turn مشابه در روز، به حدود $9.00 در روز نزدیک میشوید، حدود $270 در ماه، و بخش تاریخچه همچنان رشد میکند مگر آنکه آن را کوتاه کنید. همین محاسبه برای هر مدلی کار میکند: نرخها را از جدول بالا جایگزین کنید. یک تابع کمکی سهخطی آن را تکرارپذیر میکند:
PRICES = { # دلار آمریکا به ازای هر 1M token، لیست رسمی
"claude-opus-4-7": (5.00, 25.00),
"claude-sonnet-4-6": (3.00, 15.00),
"claude-haiku-4-5": (1.00, 5.00),
}
def cost(model: str, input_tokens: int, output_tokens: int) -> float:
in_rate, out_rate = PRICES[model]
return input_tokens / 1e6 * in_rate + output_tokens / 1e6 * out_rate
print(round(cost("claude-sonnet-4-6", 7_500, 500), 4)) # 0.03
print(round(cost("claude-opus-4-7", 7_500, 500), 4)) # 0.05محاسبات prompt caching: چه زمانی بهصرفه است
Anthropic prefixهای کششده را با دو ضریب روی نرخ پایه input قیمتگذاری میکند: نوشتن یک prefix در کش 1.25 برابر هزینه دارد (برای کش پیشفرض 5 دقیقهای، که هر بار hit شدن refresh میشود؛ یک کش 1 ساعته نوشتنش 2 برابر هزینه دارد) و خواندن آن در درخواستهای بعدی 0.1 برابر هزینه دارد. tokenهای output تحت تأثیر قرار نمیگیرند. prefixهای زیر حداقل طول قابل کش (1,024 token روی Opus و Sonnet) اصلاً کش نمیشوند. مثال محاسبهشده: یک prefix پایدار 8,000 token (system prompt بهعلاوه تعریف ابزارها) که 50 بار در بازه کش روی Sonnet 4.6 hit میشود. بدون کش، این 400,000 token input با $3.00 به ازای هر میلیون است، پس $1.20. با کش، شما یک write (8,000 token با $3.75 به ازای هر میلیون، $0.03) بهعلاوه 49 read (392,000 token با $0.30 به ازای هر میلیون، حدود $0.12) میپردازید، در مجموع حدود $0.15. هزینه prefix به حدود یکهشتم رقم بدون کش میرسد. نقطه سربهسر سریع است: یک write 1.25 برابر هزینه دارد، یک read 0.9 برابر صرفهجویی میکند، پس prefix ای که حتی دو بار در بازه دوباره استفاده شود از قبل به نفع شماست. caching فقط زمانی ضرر میکند که prefixها تقریباً در هر درخواست تغییر کنند، چون هر تغییر یک write تازه با 1.25 برابر را تحمیل میکند.
| مدل | input پایه / 1M | write کش، 5 دقیقه (1.25 برابر) | read کش (0.1 برابر) |
|---|---|---|---|
| Claude Opus 4.7 | $5.00 | $6.25 | $0.50 |
| Claude Sonnet 4.6 | $3.00 | $3.75 | $0.30 |
| Claude Haiku 4.5 | $1.00 | $1.25 | $0.10 |
بررسی آنچه صورتحساب شده: شیء usage
هر پاسخ Claude شامل یک بلوک usage با شمارش دقیق tokenهایی است که برای آنها صورتحساب شدهاید، پس هرگز لازم نیست حدس بزنید. یک تماس آزمایشی سنجیده ارسال کنید:
curl https://api.anthropic.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"max_tokens": 200,
"messages": [
{"role": "user", "content": "Explain prompt caching in one line."}
]
}'شش راه برای کاهش صورتحساب Claude
وقتی با هم روی یک حجم کار بهسبک چت اعمال شوند، مسیردهی tier بهعلاوه کوتاهسازی تاریخچه بهعلاوه caching معمولاً هزینه بیشتری نسبت به تعویض provider صورتحساب کاهش میدهند، چون خود شمارش token را کوچک میکنند، نه نرخی که روی آن اعمال میشود.
- وقتی کیفیت اجازه میدهد tier را پایین بیاورید. Haiku 4.5 طبقهبندی، مسیردهی و استخراج را با یکپنجم نرخ input در Opus انجام میدهد. Opus 4.7 را برای بخش سنگین از نظر reasoning ترافیک نگه دارید و بهطور پیشفرض از Sonnet 4.6 استفاده کنید.
- max_tokens را محدود کنید. output در هر tier از Claude پنج برابر input هزینه دارد، پس یک پاسخ پرحرف بدون سقف گرانترین حالت شکست است. سقفی متناسب با کار تنظیم کنید.
- تاریخچه را کوتاه یا خلاصه کنید. چون هر turn کل مکالمه را دوباره ارسال میکند، یک خلاصه چرخشی که جای turnهای قدیمی را میگیرد رشد input را محدود میکند بهجای اینکه اجازه دهد بهصورت خطی بالا برود.
- prefixهای پایدار را کش کنید. system promptها، schemaهای ابزار و اسناد مرجع بالای 1,024 token باید cache-marked شوند؛ محاسبات بخش قبل روی هر فراخوانی تکراری اعمال میشود.
- برای کار آفلاین از Batch API استفاده کنید. Anthropic درخواستهای batch را با نصف نرخ تعاملی صورتحساب میکند، که برای اجرای eval، backfill و jobهای شبانهای که میتوانند نتایج تأخیری را تحمل کنند مناسب است.
- مراحلی که برای Claude حیاتی نیستند را جای دیگری مسیردهی کنید. پیشنویسنویسی، برچسبگذاری و rerank بازیابی معمولاً روی deepseek-v4-flash با $0.126 / $0.252 به ازای هر میلیون token بهخوبی کار میکنند، و Claude را برای متن نهایی که کیفیتش اهمیت دارد نگه دارید.
پرسشهای پرتکرار
صورتحساب Claude API چطور کار میکند؟
پیشپرداخت و به ازای هر token است. شما اعتبار میخرید و هر درخواست tokenهای input و output را با نرخهای مدلی که فراخوانی کردهاید کسر میکند. هیچ هزینه ماهانه و هیچ کارمزد هر درخواستی فراتر از tokenها وجود ندارد؛ هر پاسخ یک بلوک usage برمیگرداند که دقیقاً نشان میدهد چه چیزی شمرده شده است.
هزینه Claude API به ازای هر 1,000 token چقدر است؟
نرخهای هر میلیون را بر 1,000 تقسیم کنید. بهطور رسمی، Haiku 4.5 برابر $0.001 ورودی / $0.005 خروجی به ازای هر 1K token است، Sonnet 4.6 برابر $0.003 / $0.015 و Opus 4.7 برابر $0.005 / $0.025. بیشتر صفحات قیمت به ازای هر میلیون token نقل میکنند، پس نرخی که بزرگ به نظر میرسد معمولاً اینطور نیست.
آیا اشتراک Claude Pro شامل اعتبار API میشود؟
خیر. Claude Pro و Max اشتراکهایی برای اپهای claude.ai هستند و جداگانه از اعتبار API در Anthropic Console صورتحساب میشوند. ساختن روی API یعنی تأمین مالی اعتبار API (یا موجودی pay-as-you-go یک gateway)؛ اشتراک چت را نمیتوان از طریق API خرج کرد.
چرا صورتحساب Claude API من بیشتر از انتظارم است؟
دلایل معمول: تاریخچه مکالمه در هر turn بهعنوان input دوباره ارسال میشود، tokenهای output پنج برابر input هزینه دارند و tokenهای extended-thinking حتی اگر آنها را نمایش ندهید بهعنوان output صورتحساب میشوند. بلوک usage روی پاسخهای واقعی را بررسی کنید؛ شمارشهای آنجا تقریباً همیشه شکاف را توضیح میدهند.
آیا prompt caching همیشه در هزینه صرفهجویی میکند؟
خیر. یک write کش 1.25 برابر نرخ پایه input هزینه دارد، پس prefix ای که تقریباً در هر درخواست تغییر میکند با caching روشن کمی هزینه بیشتری دارد. وقتی یک prefix پایدار با 1,024+ token حداقل دو بار در بازه کش دوباره استفاده شود بهصرفه میشود و agentهای عمربلند آن را بارها جبران میکنند.
آیا درخواستهای ناموفق Claude API صورتحساب میشوند؟
درخواستهایی که قبل از پردازش رد میشوند، مثل خطاهای rate-limit 429 و خطاهای احراز هویت، token مصرف نمیکنند. درخواستهایی که مدل واقعاً پردازش میکند برای tokenهای استفادهشده صورتحساب میشوند، شامل پاسخهایی که با max_tokens قطع شدهاند، پس یک پاسخ ناقص همچنان هزینه آنچه تولید شده را دارد.