تكلفة Claude API: واجهة جديدة تكشف من ينفق الرموز وعلى ماذا

في 29 أكتوبر، أتاحت Anthropic بنسخة تجريبية Usage and Cost Analytics API، وهي واجهة API جديدة لإعداد تقارير عن استهلاك الرموز (tokens) وتكلفة Claude API داخل المؤسسة. ووفقًا لـClaude Release Notes، أصبحت واجهة Usage and Cost API السابقة منذ ذلك اليوم واجهة “legacy”، مع أنها لا تزال مدعومة.

ما الجديد في تقارير تكلفة Claude API؟

للواجهة نقطتا نهاية (endpoints):

1. GET /v1/organizations/analytics/usage تُرجع عدد الرموز والطلبات،
2. GET /v1/organizations/analytics/cost تُرجع التكلفة بالدولار الأمريكي.

أكثر ما يلفت الانتباه هو الطرق التي يمكننا بها تقسيم هذه البيانات. ففي طلب واحد نجمّع النتائج حسب خمسة أبعاد كحد أقصى: النموذج، وworkspace، ومفتاح API، وفئة الخدمة، ونافذة السياق، ومنطقة الاستدلال، والمنتج، وما يُسمى “الفاعل” (actor)، أي الجهة التي أرسلت الطلب فعليًا. قد يكون الفاعل مستخدمًا، أو حساب خدمة، أو هوية من AWS أو Google Cloud، وإن لم يوجد أيٌّ من ذلك فهو مفتاح API نفسه.

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

ولـClaude Code وصفة جاهزة: التكلفة لكل مستخدم يعطيها طلب يحتوي على products[]=claude_code&group_by[]=actor. وبعد القياسات التي تُظهر أن الملخصات الخفية للوكلاء تستهلك 16–22% من تكاليف الجلسة، يأتي هذا في وقته تمامًا.

كيف يبدو الطلب؟

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

curl --globoff "https://api.anthropic.com/v1/organizations/analytics/usage?\
starting_at=2026-09-01T00:00:00Z&\
ending_at=2026-09-08T00:00:00Z&\
time_bucket_width=1d&\
group_by[]=model&\
limit=10" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: analytics-usage-cost-2026-08-24" \
  -H "x-api-key: $ANTHROPIC_API_KEY"

لكل صف ثلاثة أجزاء: النطاق الزمني، وgroup مع الأبعاد، وusage (أو cost) مع الأرقام. في usage نجد، من بين أمور أخرى، رموز الإدخال غير المخزنة مؤقتًا، والرموز المكتوبة إلى الذاكرة المؤقتة والمقروءة منها، ورموز الإخراج، وعدد عمليات البحث على الويب، وعدد الطلبات. والأمر نفسه متاح عبر SDK وأداة سطر الأوامر ant (ant beta:organization:analytics:usage list).

بعض التفاصيل:

1. الفترات الزمنية هي دقيقة واحدة أو ساعة واحدة أو يوم واحد، وكلها بتوقيت UTC.
2. يغطي الطلب الواحد 31 يومًا كحد أقصى، و24 ساعة فقط مع الفترات بالدقيقة.
3. تمتد البيانات حتى 1 يناير 2026، ولمدة لا تتجاوز 365 يومًا إلى الوراء.
4. تحتوي صفحة النتائج على من 1 إلى 1000 صف (20 افتراضيًا).

ماذا تعرض نقطة نهاية التكاليف؟

تُرجع نقطة النهاية /cost مبلغين: amount، أي التكلفة بعد الخصومات وقبل خصم الأرصدة، وlist_amount، أي التكلفة بالأسعار الرسمية. وتُعرض المبالغ بالسنتات مع ست خانات عشرية، فـ"41280.000000" تعني 412.80 دولارًا.

ويفصّل بُعدان إضافيان، cost_type وtoken_type، التكلفة حسب أنواع الرموز، والبحث على الويب، وتنفيذ الشيفرة، والجلسات. ولا يُحتسبان ضمن حد الأبعاد الخمسة.

ما الذي يجب الانتباه إليه؟

أولًا، التأخير. تتحدث البيانات عادةً خلال 4 ساعات، وأحيانًا خلال ما يصل إلى 24 ساعة، بينما كانت تظهر في Usage and Cost API القديمة عادةً خلال 5 دقائق. لذا من الأفضل البحث عن حل آخر للتنبيهات الفورية.

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

ثالثًا، Priority Tier. الطلبات المنفّذة ضمن Priority Tier مشترى تظهر في الاستهلاك، لكن تكلفة رموزها صفر، لأن رسوم الالتزام تُحتسب بشكل منفصل.

رابعًا، الوصول. تعمل الواجهة للمؤسسات فقط: في Claude Console بمفتاح Admin API، وفي Claude Enterprise بمفتاح يحمل صلاحية read:analytics. لا يمكن للحسابات الفردية استخدامها. كما تعمل على Claude Platform on AWS وفي Claude Models on Google Cloud، بآلية المصادقة الخاصة بكل سحابة.

هل هذا جديد في عالم الذكاء الاصطناعي؟

كانت تقارير التكاليف موجودة في Claude Console من قبل. الجديد هو أن نقاط النهاية والحقول نفسها تخدم مؤسسات Claude Console وClaude Enterprise على حد سواء. وبالنسبة لـEnterprise، فهذه أيضًا نهاية قيد: كانت التقارير القديمة تُرجع أكبر 100 مجموعة فقط في كل فترة، أما الجديدة فتُرجعها كلها.

إنها خطوة أخرى من Anthropic نحو التحكم في الإنفاق، مباشرةً بعد Claude smart reports التي تُظهر ما أنجزه الفريق باستخدام Claude وكم كلّف ذلك.

الأسئلة الشائعة

كيف أتحقق من تكلفة Claude API؟

في Claude Console عبر صفحتي Usage وCost، أو برمجيًا عبر Usage and Cost Analytics API (نقطة النهاية /v1/organizations/analytics/cost) بمفتاح Admin API. كما تتضمن كل استجابة فردية من الواجهة كتلة usage بعدد رموز ذلك الطلب.

هل ستتوقف Usage and Cost API القديمة عن العمل؟

حتى 29 أكتوبر، لا. وفقًا لـClaude Release Notes، فإن حالتها “legacy” لكنها لا تزال مدعومة، وتتضمن الوثائق دليلًا للترحيل.

كيف أعرف كم ينفق كل مستخدم لـClaude Code؟

عبر نقطة نهاية التكاليف مع المعاملات products[]=claude_code&group_by[]=actor. ويمكن لمؤسسات Claude Console أيضًا استخدام Claude Code Analytics API المنفصلة.