الانتقال إلى المحتوى الرئيسي
يمكن لواجهة برمجة التطبيقات لحساب رموز رسائل كلود حساب عدد رموز الإدخال لرسالة معينة دون الحاجة إلى إنشاء الرسالة فعليًا، بما في ذلك عدد رموز المحتويات مثل الأدوات والصور والمستندات. هذا مفيد جدًا عند الحاجة إلى تقدير التكاليف أو التحقق مما إذا كان الإدخال يتجاوز قيود سياق النموذج. تتناول هذه الوثيقة بشكل أساسي عملية استخدام واجهة برمجة التطبيقات لحساب رموز رسائل كلود.

عملية الطلب

لاستخدام واجهة برمجة التطبيقات لحساب رموز رسائل كلود، يمكنك أولاً زيارة صفحة واجهة برمجة التطبيقات لحساب رموز رسائل كلود والنقر على زر “Acquire” للحصول على الشهادات المطلوبة للطلب. إذا لم تكن قد قمت بتسجيل الدخول أو التسجيل، فسيتم تحويلك تلقائيًا إلى صفحة تسجيل الدخول لدعوتك للتسجيل وتسجيل الدخول، وبعد تسجيل الدخول أو التسجيل، سيتم العودة تلقائيًا إلى الصفحة الحالية. تستخدم هذه الواجهة مجانًا تمامًا، ولا تتطلب استهلاك أي رصيد.

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

مسار طلب واجهة برمجة التطبيقات لحساب رموز رسائل كلود هو /v1/messages/count_tokens، وهو متوافق مع واجهة برمجة التطبيقات الرسمية من Anthropic. نحتاج على الأقل إلى تقديم معلمين أساسيين:
  • model: اختيار النموذج المستخدم، مثل claude-sonnet-4-5-20250929، claude-opus-4-20250514، إلخ.
  • messages: مصفوفة الرسائل المدخلة، تحتوي كل رسالة على role (الدور) و content (المحتوى).
المعلمات الاختيارية الشائعة:
  • system: عبارة النظام، ستؤخذ في الاعتبار عند حساب عدد الرموز.
  • tools: تعريف الأدوات، ستؤخذ في الاعتبار عند حساب عدد الرموز.
  • thinking: إعدادات التفكير الموسعة.

مثال cURL

curl -X POST 'https://api.acedata.cloud/v1/messages/count_tokens' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer {token}' \
  -H 'content-type: application/json' \
  -d '{
    "model": "claude-sonnet-4-5-20250929",
    "messages": [
      {
        "role": "user",
        "content": "Hello, Claude"
      }
    ]
  }'

مثال Python

import httpx

url = "https://api.acedata.cloud/v1/messages/count_tokens"
headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json",
}
payload = {
    "model": "claude-sonnet-4-5-20250929",
    "messages": [
        {
            "role": "user",
            "content": "Hello, Claude"
        }
    ],
}
response = httpx.post(url, headers=headers, json=payload)
print(response.json())
مثال على نتيجة العودة:
{
  "input_tokens": 11
}

استخدام SDK من Anthropic

واجهة برمجة التطبيقات لحساب رموز رسائل كلود متوافقة تمامًا مع SDK الرسمي من Anthropic، ويمكنك استخدام مكتبة anthropic لاستدعائها مباشرة.
from anthropic import Anthropic

client = Anthropic(
    api_key="{token}",
    base_url="https://api.acedata.cloud",
)

result = client.messages.count_tokens(
    model="claude-sonnet-4-5-20250929",
    messages=[
        {
            "role": "user",
            "content": "Hello, Claude"
        }
    ],
)
print(result.input_tokens)

حساب الرموز مع الأدوات

إذا كانت طلباتك تتضمن تعريفات الأدوات، فستؤخذ هذه الأدوات أيضًا في الاعتبار عند حساب عدد الرموز:
result = client.messages.count_tokens(
    model="claude-sonnet-4-5-20250929",
    messages=[
        {
            "role": "user",
            "content": "What is the weather in San Francisco?"
        }
    ],
    tools=[
        {
            "name": "get_weather",
            "description": "Get the current weather in a given location",
            "input_schema": {
                "type": "object",
                "properties": {
                    "location": {
                        "type": "string",
                        "description": "The city and state, e.g. San Francisco, CA"
                    }
                },
                "required": ["location"]
            }
        }
    ],
)
print(result.input_tokens)

حساب الرموز مع عبارة النظام

ستؤخذ عبارة النظام أيضًا في الاعتبار عند حساب عدد الرموز:
result = client.messages.count_tokens(
    model="claude-sonnet-4-5-20250929",
    system="You are a helpful assistant that speaks Chinese.",
    messages=[
        {
            "role": "user",
            "content": "Hello"
        }
    ],
)
print(result.input_tokens)

ملاحظات

  • هذه الواجهة تحسب فقط عدد رموز الإدخال، ولن تنتج أي مخرجات من النموذج.
  • يمكن استخدام نتائج حساب الرموز لتقدير تكاليف استدعاء واجهة برمجة التطبيقات لرسائل كلود.
  • قد تختلف طرق تحويل الرموز بين النماذج المختلفة، يرجى استخدام معلمة النموذج نفسها المستخدمة في الاستدعاء الفعلي.
  • هذه الواجهة مجانية تمامًا، ولا تستهلك أي رصيد.