النص

حساب توكنات الرسالة

حساب توكنات الإدخال لطلب الرسائل (Messages) دون إنشاء استجابة.

POST
/v1/messages/count_tokens

نظرة عامة

أرسل نفس حقول model و messages و system و tools و thinking كما في إنشاء رسالة، ولكن بدون max_tokens، وذلك لحساب توكنات الإدخال قبل إرسال الطلب. يجب أن يدرج النموذج anthropic_messages ضمن accepted_request_formats.

ملاحظات

  • تتطلب عملية حساب التوكنات مفتاح API ولا يتم محاسبتك عليها.
  • هذا الحساب مخصص لأغراض التخطيط. أما الرسوم الخاصة بالطلب الفعلي فتتم بناءً على usage في استجابته.
  • تفضل TokenLab الحصول على الحساب من عداد النموذج نفسه. عندما لا يكون هذا العداد متاحاً، تُرجع TokenLab تقديراً محلياً وتضبط ترويسة الاستجابة على X-TokenLab-Count-Tokens-Source: local_estimate.
  • ستظل أخطاء المصادقة والأذونات والإدخال تؤدي إلى فشل الطلب. الطلب الذي يشير إلى file_id يحتاج إلى عداد النموذج نفسه، ويُرجع 503 في حال عدم توفره. أرسل anthropic-beta: files-api-2025-04-14 مع مثل هذا الطلب.

مثال

الطلب

cURL
curl -X POST "https://api.tokenlab.sh/v1/messages/count_tokens" \
  -H "x-api-key: sk-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [
      {"role": "user", "content": "Hello, Claude!"}
    ]
  }'

الاستجابة

200 OK
{
  "input_tokens": 12
}

حقول هامة

input_tokensinteger
العدد التقديري لتوكنات الإدخال في الطلب.

التفويض

BearerAuth
AuthorizationBearer <token>

مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.

الموضع: header

جسم الطلب

application/json

الاستجابة

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json