عملية الطلب
لاستخدام واجهة برمجة التطبيقات لحساب رموز رسائل كلود، يجب أولاً الذهاب إلى وحدة التحكم في بيانات Ace للحصول على رمز API الخاص بك، للاحتفاظ به كنسخة احتياطية.
إذا لم تكن قد قمت بتسجيل الدخول أو التسجيل بعد، فسيتم تحويلك تلقائيًا إلى صفحة تسجيل الدخول لدعوتك للتسجيل وتسجيل الدخول، وبعد الانتهاء، سيتم إرجاعك تلقائيًا إلى الصفحة الحالية.
يمكن استخدام رمز API واحد لاستدعاء جميع خدمات المنصة، دون الحاجة لتقديم طلب منفصل لكل خدمة. ستمنحك أول عملية طلب رصيدًا مجانيًا لتجربته مجانًا؛ وعند نفاد الرصيد، يمكنك إعادة شحن الرصيد العام في وحدة التحكم.
📘 الوثيقة الكاملة: واجهة برمجة التطبيقات لحساب رموز رسائل كلود →
الاستخدام الأساسي
مسار طلب واجهة برمجة التطبيقات لحساب رموز رسائل كلود هو/v1/messages/count_tokens، وهو متوافق مع واجهة برمجة التطبيقات الرسمية من Anthropic. نحتاج على الأقل إلى تقديم معلمين أساسيين:
model: اختيار نموذج كلود المستخدم، مثل أحدث نموذج رائدclaude-fable-5-1؛ لا يزال النموذج الأصليclaude-fable-5متوافقًا.messages: مصفوفة الرسائل المدخلة، تحتوي كل رسالة علىrole(الدور) وcontent(المحتوى).
system: عبارة النظام، ستؤخذ في الاعتبار عند حساب عدد الرموز.tools: تعريف الأدوات، ستؤخذ في الاعتبار عند حساب عدد الرموز.thinking: إعدادات التفكير الموسعة.tool_choice: إعدادات اختيار الأدوات.cache_control: إعدادات التحكم في التخزين المؤقت على مستوى الكتلة أو المحتوى.
messages و system واستدعاءات أدوات التشغيل وإعادة تشغيل الصور URL وكتل المحتوى document/PDF نفس هيكل الطلب المستقر كما في واجهة برمجة التطبيقات للرسائل.
مثال cURL
مثال Python
استخدام SDK من Anthropic
تقبل واجهة برمجة التطبيقات لحساب رموز رسائل كلود هيكل الطلب المستقر من SDK من Anthropic، ويمكن استدعاؤها من خلال مكتبةanthropic. القيمة المرجعة الحالية يتم حسابها بواسطة مقدر محلي من Ace Data Cloud، وليست نتيجة دقيقة من tokenizer الرسمي من Anthropic؛ قد يكون هناك انحراف في عدد الرموز الفعلي للنماذج متعددة الوسائط والأدوات ونماذج كلود المختلفة.
حساب الرموز مع الأدوات
إذا كانت طلباتك تتضمن تعريفات الأدوات، فستؤخذ هذه الأدوات أيضًا في الاعتبار عند حساب عدد الرموز:حساب الرموز مع عبارة النظام
ستؤخذ عبارة النظام أيضًا في الاعتبار عند حساب عدد الرموز:ملاحظات
- تقوم هذه الواجهة بحساب عدد رموز الإدخال فقط، ولن تنتج أي مخرجات من النموذج.
- يمكن استخدام نتائج حساب الرموز لتقدير تقريبي لحجم الإدخال، ولا ينبغي اعتبارها أساسًا دقيقًا للفوترة أو قيود نافذة السياق أو مقارنة tokenizer للنموذج.
- لا يقوم المقدّر الحالي بحساب الرموز البصرية/المستندات بدقة للصور وPDF، ولا يمكنه عكس الفروق بين tokenizer الرسمي لنماذج كلود المختلفة.
- هذه الواجهة مجانية تمامًا، ولا تستهلك أي رصيد.

