الانتقال إلى المحتوى الرئيسي
يمكن لـ Claude Messages Count Tokens API حساب عدد رموز الإدخال لرسالة Message دون إنشاء الرسالة فعليًا، بما في ذلك عدّ الرموز لمحتوى مثل الأدوات والصور والمستندات. وهذا مفيد جدًا عند الحاجة إلى تقدير التكلفة أو التحقق مما إذا كان الإدخال يتجاوز حد سياق النموذج. تقدم هذه الوثيقة بشكل أساسي عملية استخدام Claude Messages Count Tokens API.

عملية التقديم

لاستخدام Claude Messages Count Tokens API، انتقل أولًا إلى وحدة تحكم Ace Data Cloud للحصول على API Token الخاص بك، واحتفظ به للاستخدام لاحقًا. إذا لم تكن قد سجلت الدخول أو أنشأت حسابًا بعد، فسيتم تحويلك تلقائيًا إلى صفحة تسجيل الدخول لدعوتك إلى التسجيل وتسجيل الدخول، وبعد الإكمال ستعود تلقائيًا إلى الصفحة الحالية. يمكن لـ API Token واحد استدعاء جميع خدمات المنصة، ولا حاجة للتقديم بشكل منفصل لكل خدمة. سيمنحك أول تقديم رصيدًا مجانيًا لتجربة الخدمة مجانًا؛ وعند عدم كفاية الرصيد، يمكنك إعادة شحن الرصيد العام من وحدة التحكم.
📘 الوثائق الكاملة: Claude Messages Count Tokens API →

الاستخدام الأساسي

مسار طلب Claude Messages Count Tokens API هو /v1/messages/count_tokens، وهو متوافق مع Anthropic Official API. نحتاج على الأقل إلى تقديم معاملين إلزاميين:
  • model: اختر نموذج Claude المراد استخدامه؛ يمكن استخدام claude-opus-5-5 لـ Messages Token Count، مثل أحدث نموذج رائد claude-fable-5-1؛ ولا يزال claude-fable-5 الأصلي محفوظًا ومتوافقًا. تمت إضافة claude-sonnet-5-5 إلى واجهة Messages الأصلية، وهو يدعم إدخال الصور والتفكير التكيفي؛ وأسعاره المرجعية الرسمية للإدخال والإخراج وقراءة التخزين المؤقت هي 2 و10 و0.20 دولار أمريكي لكل مليون Token، على التوالي.
  • messages: مصفوفة الرسائل المدخلة، وتحتوي كل رسالة على role (الدور) وcontent (المحتوى).
المعاملات الاختيارية الشائعة:
  • system: مطالبة النظام، وسيتم احتسابها ضمن عدد Token.
  • tools: تعريفات الأدوات، وسيتم احتسابها ضمن عدد Token.
  • thinking: إعداد التفكير الموسع.
  • tool_choice: إعداد اختيار الأداة.
  • cache_control: إعداد التحكم في التخزين المؤقت على المستوى الأعلى أو على مستوى كتلة المحتوى.
تستخدم كتل محتوى messages وsystem وإعادة تشغيل استدعاءات الأدوات وصور URL وdocument/PDF نفس بنية الطلب المستقرة الخاصة بـ Messages API.

مثال cURL

مثال Python

مثال على النتيجة المعادة:

استخدام Anthropic SDK

يقبل Claude Messages Count Tokens API بنية الطلب المستقرة لـ Anthropic SDK، ويمكن استدعاؤه عبر مكتبة anthropic. تستخدم الواجهة قدرة Count Tokens الأصلية المقابلة للنموذج المحدد لإحصاء الإدخال، ويمكن استخدامها للتحقق من حجم الإدخال قبل إرسال طلب Messages.

عدّ Token التي تتضمن الأدوات

إذا كان طلبك يتضمن تعريفات الأدوات، فسيتم احتساب هذه الأدوات أيضًا ضمن عدد Token:

عدّ Token التي تتضمن مطالبة النظام

سيتم احتساب مطالبة النظام أيضًا ضمن عدد Token:

ملاحظات

  • تحسب واجهة API هذه عدد Token للإدخال فقط، ولن تنتج أي مخرجات من النموذج.
  • يمكن استخدام نتيجة عدّ Token لتقدير حجم الإدخال والتحقق من نافذة السياق؛ وتكون الفوترة النهائية وفقًا لـ usage في استجابة Messages الفعلية.
  • سيتم احتساب الصور وملفات PDF وتعريفات الأدوات ومطالبات النظام وإعدادات thinking في النتيجة وفقًا لقواعد الإدخال للنموذج المحدد.
  • واجهة API هذه مجانية بالكامل ولا تستهلك أي رصيد.