عملية التقديم
لاستخدام 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 هذه مجانية بالكامل ولا تستهلك أي رصيد.

