Claude Opus 4.7 API: دليل الأسعار والتوكنز وPrompt Caching
في Anthropic API، يبدأ تسعير Claude Opus 4.7 من 5 دولارات لكل مليون توكن إدخال و25 دولارًا لكل مليون توكن إخراج؛ لكن Prompt Caching والـ tokenizer الجديد قد يغيّران التكلفة الفعلية.[19][20] لا تعتمد على عدد الكلمات أو الحروف: استخدم /v1/messages/count tokens قبل الإرسال، ثم سجّل حقول usage بعد الاستجابة للمحاسبة الد...
Claude Opus 4.7 API 收費指南：$5/$25、Token 計法同成本公式AI-generated editorial illustration for Claude Opus 4.7 API pricing and token accounting.
موجّه الذكاء الاصطناعي
Create a landscape editorial hero image for this Studio Global article: Claude Opus 4.7 API 收費指南：$5/$25、Token 計法同成本公式. Article summary: Claude Opus 4.7 API 基礎價係每百萬 input tokens $5、每百萬 output tokens $25；但 prompt caching 要另計，而且新 tokenizer 可能令同一段文字用大約 1x 至 1.35x token。[19][20]. Topic tags: ai, anthropic, claude, api pricing, llm. Reference image context from search candidates: Reference image 1: visual subject "# Claude Opus 4.7 上线完全指南（2026 最新）：核心升级与国内 API 接入方案. **Claude Opus 4.7 于 2026 年 4 月 16 日正式发布，API model ID 为 `claude-opus-4-7`，定价维持与 Opus 4.6 相同的 $5/M 输入 token、$25/M 输出 token 不变，1M t" source context "Claude Opus 4.7 上线完全指南（2026 最新）：核心升级与 ..." Reference image 2: visual subject "# Claude Opus 4.7 上线完全指南（2026 最新）：核心升级与国内 API 接入方案. **Claude Opus 4.7 于 2026 年 4 月 16 日正式发布，API model ID 为 `claude-opus-4-7`，定价维持与 Opus 4.6 相同的 $5/M 输入 token、$25/M 输出 token 不变，1M t" source context "Claude Opus 4.
openai.com
تسعير Claude Opus 4.7 يبدو للوهلة الأولى سهلًا: 5 دولارات للإدخال و25 دولارًا للإخراج لكل مليون توكن. لكن في التطبيقات الحقيقية — روبوت دعم، وكيل برمجي، نظام تحليل مستندات، أو أداة داخلية طويلة السياق — الخطأ الشائع هو ضرب “إجمالي التوكنز” في سعر واحد. هذا سيعطيك رقمًا مضللًا.
تقول Anthropic إن المطورين يستطيعون استخدام النموذج عبر Claude API بالمعرّف claude-opus-4-7. وتعرض مستندات التسعير الرسمية بنودًا منفصلة لتوكنز الإدخال الأساسية، وكتابة Prompt Cache، وقراءة الكاش، وتوكنز الإخراج. كما تعرض مؤشرات تسعير خارجية بداية السعر نفسها: 5 دولارات لكل مليون input tokens و25 دولارًا لكل مليون output tokens، لكن إذا وصلت إلى النموذج عبر مزوّد أو منصة وسيطة، فراجع فاتورة تلك المنصة وشروطها النهائية.
الخلاصة السريعة: ليس السعر مجرد 5 و25 دولارًا
في هذا الدليل، سنستخدم “مليون توكن” للدلالة على 1,000,000 توكن. وبحسب صفحة تسعير Anthropic، يجب التعامل مع بنود التكلفة كفئات منفصلة، لا كرقم واحد.
بند التكلفة
السعر
ماذا يعني؟
Studio Global AI
Search, cite, and publish your own answer
Use this topic as a starting point for a fresh source-backed answer, then compare citations before you share it.
ما هي الإجابة المختصرة على "Claude Opus 4.7 API: دليل الأسعار والتوكنز وPrompt Caching"؟
في Anthropic API، يبدأ تسعير Claude Opus 4.7 من 5 دولارات لكل مليون توكن إدخال و25 دولارًا لكل مليون توكن إخراج؛ لكن Prompt Caching والـ tokenizer الجديد قد يغيّران التكلفة الفعلية.[19][20]
ما هي النقاط الأساسية التي يجب التحقق منها أولاً؟
في Anthropic API، يبدأ تسعير Claude Opus 4.7 من 5 دولارات لكل مليون توكن إدخال و25 دولارًا لكل مليون توكن إخراج؛ لكن Prompt Caching والـ tokenizer الجديد قد يغيّران التكلفة الفعلية.[19][20] لا تعتمد على عدد الكلمات أو الحروف: استخدم /v1/messages/count tokens قبل الإرسال، ثم سجّل حقول usage بعد الاستجابة للمحاسبة الدقيقة.[17][18]
ماذا يجب أن أفعل بعد ذلك في الممارسة العملية؟
لا تجمع كل التوكنز في رقم واحد؛ يجب حساب input tokens وoutput tokens وكتابة الكاش وقراءة الكاش كلٌ بسعره، خصوصًا عند استخدام streaming.[15][19]
توكنز الإدخال العادية التي تُرسل إلى النموذج ولا تُحتسب ككتابة أو قراءة كاش.
Output tokens
25 دولارًا / مليون توكن
التوكنز التي ينتجها Claude في الرد.
Prompt cache write — مدة 5 دقائق
6.25 دولار / مليون توكن
عند كتابة محتوى قابل لإعادة الاستخدام في الكاش بمدة صلاحية 5 دقائق.
Prompt cache write — مدة ساعة
10 دولارات / مليون توكن
عند استخدام مدة صلاحية ساعة واحدة لكتابة الكاش.
Cache read / hit
0.50 دولار / مليون توكن
عند قراءة محتوى موجود مسبقًا في الكاش.
المغزى العملي: إذا كان تطبيقك يستخدم Prompt Caching، فلا يكفي أن تحفظ “إجمالي التوكنز”. احتفظ بكل بند على حدة: إدخال عادي، إخراج، كتابة كاش، وقراءة كاش.
معادلة التكلفة من دون Prompt Caching
إذا لم تستخدم Prompt Caching، فالمعادلة الأساسية هي:
إذا كنت تستخدم نوعًا واحدًا فقط من مدة صلاحية الكاش، فاحتفظ ببند الكتابة المناسب فقط. تعرض وثائق Anthropic في أمثلة streaming حقول استخدام مثل input_tokens وoutput_tokens وcache_creation_input_tokens وcache_read_input_tokens، كما تفصل صفحة التسعير بين كتابة الكاش وقراءة الكاش.
كيف تعرف عدد التوكنز قبل إرسال الطلب؟ استخدم count_tokens
لا تحاول تقدير التكلفة من عدد الكلمات العربية أو الإنجليزية أو من عدد الحروف. التوكنز ليست “كلمات” بالضرورة، وقد تختلف حسب اللغة، التنسيق، الأدوات، والصور أو ملفات PDF داخل الطلب.
الطريقة الأكثر أمانًا هي استخدام endpoint الرسمي:
/v1/messages/count_tokens
توضح Anthropic أن هذا endpoint يحسب عدد التوكنز في الرسالة قبل إرسالها إلى Claude، ويقبل بنية إدخال مشابهة لإنشاء رسالة في Messages API، بما في ذلك system prompts وtools والصور وملفات PDF، ثم يعيد إجمالي توكنز الإدخال. كما تشير الوثائق إلى أن كل النماذج النشطة تدعم عدّ التوكنز.
عمليًا، أرسل إلى count_tokens النسخة نفسها تقريبًا من الـ payload الذي سترسله إلى Messages API: رسائل المستخدم، system prompt، تعريفات الأدوات، الصور، وملفات PDF إن وجدت. بهذه الطريقة يمكنك وضع حد أقصى للتكلفة، أو إظهار تحذير للمستخدم، أو منع الطلبات المكلفة قبل تنفيذها.
بعد تنفيذ الطلب: اعتمد على usage لا على طول النص
بعد انتهاء الطلب، لا تُعدّ كلمات الرد لتخمين التكلفة. سجّل حقول usage التي ترجعها الاستجابة.
أمثلة Messages API في وثائق Anthropic تعرض حقولًا مثل input_tokens وoutput_tokens، بينما تعرض وثائق streaming حقولًا إضافية مرتبطة بالكاش مثل cache_creation_input_tokens وcache_read_input_tokens.
إذا كنت تستخدم streaming، انتبه لنقطة مهمة: توضح وثائق Anthropic أن عدد التوكنز في message_delta.usage هو عدد تراكمي، وليس زيادة جديدة في كل حدث. إذا جمعت كل delta كما لو أنها أرقام مستقلة، فستحسب التوكنز نفسها أكثر من مرة.
للمحاسبة الشهرية: استخدم Usage & Cost Admin API
سجلّ الاستجابة لكل طلب مفيد للمراقبة الفورية داخل التطبيق، لكنه ليس دائمًا كافيًا لإغلاق حسابات فريق كامل أو تقسيم التكلفة بين مساحات عمل متعددة.
توفر Anthropic واجهة Usage & Cost Admin API للوصول البرمجي والتفصيلي إلى بيانات الاستخدام والتكلفة التاريخية للمؤسسة. وتذكر الوثائق أن تقارير الاستخدام يمكن تقسيمها حسب النموذج، وworkspace، وservice tier.
بصيغة أبسط: استخدم usage داخل التطبيق لضبط الميزانية لحظيًا، واستخدم Usage & Cost Admin API للمراجعة الشهرية، وتحليل الاتجاهات، وتقسيم الفواتير بين الفرق.
الترقية إلى Opus 4.7؟ أعد حساب ميزانية التوكنز
لا تفترض أن الفاتورة ستبقى كما هي لمجرد أن السعر الأساسي هو 5 دولارات و25 دولارًا لكل مليون توكن. توضح وثائق Anthropic أن Claude Opus 4.7 يستخدم tokenizer جديدًا قد يستهلك تقريبًا من 1x إلى 1.35x من عدد التوكنز مقارنة بالنماذج السابقة عند معالجة النصوص، أي حتى نحو 35% أكثر بحسب المحتوى. كما أن /v1/messages/count_tokens قد يعيد رقمًا مختلفًا لـ Opus 4.7 مقارنةً بـ Opus 4.6 على النص نفسه.
لذلك، قبل نقل نظام إنتاجي من Opus 4.6 أو نموذج أقدم إلى Opus 4.7، خذ عيّنة من أكثر الطلبات استخدامًا وكلفة: المطالبات الطويلة، السياقات الممتدة، تعريفات الأدوات، وسير العمل الذي ينتج مخرجات كبيرة. شغّلها عبر /v1/messages/count_tokens، ثم حدّث حدود الإنفاق والتنبيهات وقيود الاستخدام بناءً على الأرقام الجديدة.
قائمة فحص سريعة قبل الإطلاق
تأكد من استخدام model ID الصحيح: claude-opus-4-7.
قبل الإطلاق أو الترقية، اختبر payloads ممثلة عبر /v1/messages/count_tokens.
خزّن input_tokens وoutput_tokens وcache_creation_input_tokens وcache_read_input_tokens كبنود منفصلة، لا كرقم إجمالي واحد.
عند استخدام streaming، تذكّر أن message_delta.usage تراكمي، فلا تجمعه حدثًا بعد حدث على أنه زيادات منفصلة.
استخدم Usage & Cost Admin API للمحاسبة التاريخية، وتقسيم التكلفة حسب النموذج أو workspace أو service tier.
إذا كنت تنتقل من نموذج Claude أقدم إلى Opus 4.7، أعد اختبار أثر الـ tokenizer الجديد على مطالباتك الفعلية.
الخلاصة: سعر Claude Opus 4.7 API الأساسي واضح — 5 دولارات لكل مليون توكن إدخال و25 دولارًا لكل مليون توكن إخراج. لكن التكلفة الدقيقة تحتاج إلى ثلاث عادات: عدّ التوكنز قبل الإرسال، تسجيل usage بعد الاستجابة، وفصل Prompt Caching والـ tokenizer الجديد في نموذج التكلفة.
platform.claude.comUsing the Messages API - Claude API Docs
