عد الرموز قبل إرسال طلب إلى Claude API يساعد في فحص حجم المدخلات، لكنه ليس فاتورة نهائية ولا وعدًا بعدد رموز الإجابة. هذا دليل للتحضير لعام 2027 وفق الوثائق العامة المتاحة في 27 أكتوبر 2026، لا إعلانًا عن ميزة مستقبلية.
ما الذي يقيسه الطلب؟
تستخدم نقطة النهاية /v1/messages/count_tokens لحساب تقديري للمدخلات دون إنشاء إجابة. ترسل بنية الرسائل والنموذج المطلوب، وقد تشمل الرسالة تعليمات النظام وتعريفات الأدوات والصور ومستندات PDF المدعومة.
وتعود النتيجة في الحقل input_tokens. لذلك لا تعد النص الذي كتبه المستخدم وحده وتغفل بقية السياق والأدوات، ولا تعامل الرقم على أنه مجموع المدخلات والمخرجات الذي سيحاسب عليه الطلب الفعلي.
ليس كل طلب مقبولًا في العد
قد تقبل واجهة إنشاء الرسائل مدخلات ترفضها واجهة العد. من الاستثناءات أدوات الخادم، مثل البحث على الويب وجلب الصفحات وتنفيذ الشيفرة والبحث عن الأدوات، مع استثناء أداة المستشار من هذا القيد، وكذلك موصل MCP.
ولا تقبل واجهة العد مصادر الصور أو المستندات من نوع url أو file. ولعد الصور وPDF تستخدم بيانات Base64 ضمن المتطلبات المدعومة، بدل افتراض أن نجاح إرسال رابط أو معرف ملف في مسار آخر يضمن نجاحه هنا.
إذا احتوى الطلب على أدوات خادم أو خوادم MCP، راجع استهلاك الطلب المنفذ في كائن usage الذي تعيده واجهة الرسائل. لا تعرض فشل العد بوصفه دليلًا على أن الميزة غير مدعومة في إنشاء الرسائل نفسه.
أعد العد عند تغيير النموذج
يحسب الطلب وفق النموذج المحدد فيه. وقد تختلف طريقة تقسيم النص إلى رموز بين أجيال النماذج؛ لذلك أعد قياس الطلب نفسه عند الانتقال، بدل نقل نتيجة نموذج قديم إلى نموذج آخر لتقدير ملاءمة السياق أو التكلفة.
والعدد تقديري، وقد يختلف قليلًا عن المدخلات الفعلية عند إنشاء الرسالة. كما لا يحسب وحده طول الإجابة التي لم تنشأ بعد، فافصل بين سعة المدخلات وخطة المخرجات في تقدير الاستخدام.
المجانية ليست تخزينًا مؤقتًا
العد مجاني وفق الوثائق الحالية، لكنه يخضع لحدود طلبات في الدقيقة منفصلة عن حدود إنشاء الرسائل. راجع فئة الاستخدام الفعلية بدل افتراض أن المجانية تسمح بطلبات بلا حد.
ولا يؤدي تمرير cache_control إلى إنشاء تخزين مؤقت للمقدمة في طلب العد. يعمل التخزين المؤقت أثناء إنشاء الرسائل الفعلي؛ فلا تحسب نتيجة العد كإثبات لحدوث تخزين أو وفر مالي تحقق بالفعل.
