Tokens للمبتدئ: ازاي تحسب تكلفة Claude API قبل ما تبعت أول request

السبب إن العربية مش موجودة بكثافة كافية في بيانات تدريب الـ tokenizer (الغالبية إنجليزية + كود). فالكلمات العربية بتتقسّم لقطع أكتر. متوسط 2.4 token لكل كلمة عربية مقابل 1.3 token لكل كلمة إنجليزية، حسب دراسة Petrov 2023 "All Languages Are Not Created (Tokenized) Equal".

ليه ده مهم بالظبط للفاتورة؟

أسعار Claude Sonnet 4.6 الرسمية على Anthropic API (مايو 2026):

• Input tokens: $3 لكل مليون token
• Output tokens: $15 لكل مليون token (خمسة أضعاف الـ input)
• Cached input: $0.30 لكل مليون token (10% بس من سعر الـ input العادي)

دلوقتي، تخيّل شات بوت دعم فني عربي بيتعامل مع 200 سؤال في اليوم:

• System prompt: 1,800 token (بيتبعت مع كل request)
• متوسط سؤال المستخدم: 60 كلمة عربية ≈ 145 tokens
• متوسط رد Claude: 180 كلمة عربية ≈ 430 tokens

حساب فاتورة الشهر (30 يوم × 200 سؤال = 6,000 request):

• Input: 6,000 × (1,800 + 145) = 11,670,000 token × $3/M = $35.01
• Output: 6,000 × 430 = 2,580,000 token × $15/M = $38.70
• المجموع: $73.71 شهرياً

لو نفس النشاط بالإنجليزي:

• السؤال هيبقى ≈ 80 token بدل 145 (–45%)
• الرد هيبقى ≈ 235 token بدل 430 (–45%)
• المجموع: $42.30 شهرياً

الفرق: $31.41 شهرياً = 74% زيادة على نفس الـ workload، مجرد لأن اللغة عربي. ده اللي بيفاجئ المطوّرين العرب اللي بيقروا تكلفة Claude على benchmarks إنجليزية.

ازاي تحسب التكلفة بنفسك قبل ما تبعت أول request

فيه طريقتين عمليتين:

الطريقة 1: تقدير سريع بـ rule of thumb

1. عد الكلمات في النص.
2. اضرب × 2.4 لو عربي، × 1.3 لو إنجليزي، × 2.0 لو كود.
3. هتطلع تقدير tokens بفرق ±15%.

كافي للتقدير المبدئي قبل ما تكتب أي كود.

الطريقة 2: حساب فعلي بـ anthropic SDK

Anthropic بتوفّر endpoint مجاني اسمه count_tokens بيرجّعلك العدد الحقيقي بدون ما تستهلك tokens فعلية ولا تدفع. ده الكود الفعلي:

كل request هيكلّفك أقل من سنت. لكن لما تضرب في 6,000 request شهرياً، الـ $0.00674 بيبقى $40.44. وده الرقم اللي لازم تحسبه قبل ما تنشر.

الـ trade-offs اللي محدش بيقولك عليها

الحساب اللي فوق دقيق، لكن فيه 4 حاجات بتغيّر الرقم في الإنتاج:

1. السياق التراكمي: في شات multi-turn، انت بتبعت كل المحادثة السابقة في كل request. محادثة بـ 10 رسائل بتكلّفك أكتر بكثير من 10 رسائل منفصلة. التكلفة بتزيد بشكل تربيعي تقريباً.
2. Prompt Caching بيقلب اللعبة: لو الـ system prompt ثابت، استخدم cache_control فالـ 1,800 token تكلفتها هتنزل من $3 لكل مليون لـ $0.30 لكل مليون (90% توفير) بعد أول request. ده ممكن يخفّض المثال اللي فوق من $73 لـ $18 شهرياً.
3. Output أغلى بـ 5 أضعاف: أي توفير لازم يركّز على output الأول. max_tokens=300 أفضل من max_tokens=2000 لو ردودك ما بتعدّيش 300 token عادةً. مفيش refund لو ما استخدمتش الـ max.
4. الـ tokenizer بيتغيّر: Anthropic بتحدّث الـ tokenizer مع كل generation من الموديل (Claude 3 vs Claude 4 مختلفين). حسابات قديمة من 2024 ممكن تكون منحرفة 8–12% على الموديلات الحالية.

متى ما تتعبش نفسك في الحساب أصلاً

الحساب التفصيلي ده مهم في الحالات دي:

• مشروع متوقّع > 1,000 request يومياً.
• محتوى عربي أو متعدد اللغات (الفرق بيكون كبير عن الإنجليزي).
• system prompt > 500 token (الـ caching هيوفّر فلوس فعلية).

لكن لو انت بتعمل prototype في الأسبوعين الأولين وبتختبر فكرة على 50 request في اليوم، حط حد $20 على Anthropic Console وكمّل. الوقت اللي هتضيّعه في الحساب المسبق أغلى من الفاتورة المتوقّعة. الحساب الجاد بييجي لما يكون فيه قرار scaling حقيقي.

الخطوة التالية

افتح terminal دلوقتي، نزّل pip install anthropic==0.49.0، انسخ الـ function estimate_cost اللي فوق، واكتب الـ system prompt اللي ناوي تستخدمه فعلاً. لو طلع > 1,000 token، ده مؤشّر إنك محتاج تفعّل cache_control من أول يوم. ابعتلي الرقم اللي طلعلك في تعليق وأقولك لو في فرصة تخفّضه قبل ما تبدأ.

المصادر

• Anthropic — Pricing Page (Claude Sonnet 4.6 input/output/cached rates): anthropic.com/pricing
• Anthropic — Token Counting API documentation: docs.claude.com
• Sennrich, R., Haddow, B., & Birch, A. (2016). Neural Machine Translation of Rare Words with Subword Units (الورقة الأصلية لـ BPE) — arXiv:1508.07909.
• Petrov, A., La Malfa, E., Torr, P., & Bibi, A. (2023). Language Model Tokenizers Introduce Unfairness Between Languages — NeurIPS 2023. (الدراسة اللي قاست الفرق بين العربية والإنجليزية في tokenization).
• Anthropic — Prompt Caching guide (تفاصيل cache_control وأسعار 10%): docs.claude.com/prompt-caching