تقدير الرموز (Anthropic)

يقدّر حجم إدخال Messages من دون توليد إجابة.

POST https://api.cloudzir.com/anthropic/v1/messages/count_tokens

المصادقة#

x-api-key: zir_ai_<48 caractères hexadécimaux>
content-type: application/json
anthropic-version: 2023-06-01

يُقبل أيضًا Authorization: Bearer ….

المعاملات#

الحقل	النوع	الوصف
`model` إلزامي	string	معرّف نموذج متاح في `GET /anthropic/v1/models`.
`messages` إلزامي	قائمة غير فارغة	رسائل `user` و`assistant`. المحتوى سلسلة نصية أو كتل نصية وأدوات.
`system`	string أو array	نص النظام أو قائمة كتل `text`. يدخل في التقدير.
`tools`	array	أدوات تحتوي `name` و`input_schema`. تدخل تعريفاتها في التقدير.

الطلب#

curl https://api.cloudzir.com/anthropic/v1/messages/count_tokens \
  -H "x-api-key: $CLOUDZIR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "mina-low",
    "system": "Réponds brièvement.",
    "messages": [{"role": "user", "content": "Bonjour Mina"}]
  }'

الاستجابة#

{"input_tokens": 21}

الترويسة	القيمة
`X-CloudZIR-Token-Count-Estimated`	`true`
`X-CloudZIR-Token-Count-Method`	`unicode_chars_div_4`

النتيجة تقديرية وليست العدد الدقيق لرموز النموذج. لا تخصم هذه الواجهة تكلفة التوليد.

الأخطاء والحدود#

400، 401، 403، 404، 413، 429، 500، 503. تُرفض الصور والمستندات داخل المحتوى برمز 400. يضبط الخادم حدود حجم جسم JSON وعمقه وحجم القوائم. يجب أن يكون النموذج مفعّلًا للمفتاح، لكن العد لا يستهلك رصيد التوليد. انظروا أكواد الأخطاء.

استجابة API