إتقان 3 آليات أساسية للفوترة في ذاكرة التخزين المؤقت لـ Claude API: مقارنة أسعار كتابة ذاكرة التخزين المؤقت لمدة 5 دقائق مقابل ساعة واحدة وشرح مفصل لعزل ذاكرة التخزين المؤقت عبر الحسابات

ملاحظة المؤلف: تحليل عمق لآلية فوترة ذاكرة التخزين المؤقت لـ Claude API، ومقارنة فرق السعر بين كتابة ذاكرة التخزين المؤقت لمدة 5 دقائق وساعة واحدة، والإجابة على مسألة إصابة ذاكرة التخزين المؤقت عبر الحسابات، ومقارنة الفرق في فوترة ذاكرة التخزين المؤقت بين AWS Bedrock وواجهة برمجة التطبيقات الرسمية من Anthropic.

تعتبر ذاكرة التخزين المؤقت للموجه (Prompt Caching) في Claude API وسيلة أساسية لتقليل تكلفة استدعاء واجهة برمجة التطبيقات، لكن العديد من المطورين لديهم شكوك حول تفاصيل فوترة ذاكرة التخزين المؤقت: كيف تختار بين ذاكرة التخزين المؤقت لمدة 5 دقائق وساعة واحدة؟ هل يمكن مشاركة ذاكرة التخزين المؤقت عبر الحسابات؟ ما الفرق في فوترة ذاكرة التخزين المؤقت بين AWS Bedrock والإصدار الرسمي؟

القيمة الأساسية: بعد قراءة هذه المقالة، ستفهم تمامًا الآليات الأساسية الثلاث لفوترة ذاكرة التخزين المؤقت في Claude API، وستتقن طريقة اختيار استراتيجية ذاكرة التخزين المؤقت الأمثل، وتتجنب هدر التكاليف غير الضرورية.

النقاط الأساسية للفوترة في ذاكرة التخزين المؤقت لـ Claude API

معدل الفوترة الأساسي لـ Claude API

يستخدم Prompt Caching في Claude API نظام فوترة موحد، بغض النظر عن النموذج المستخدم (Opus 4.6 أو Sonnet 4.6 أو Haiku 4.5)، تكون قواعد معدل عمليات ذاكرة التخزين المؤقت متطابقة تمامًا:

• كتابة ذاكرة التخزين المؤقت (عمر 5 دقائق) : السعر الأساسي للإدخال × 1.25
• كتابة ذاكرة التخزين المؤقت (عمر ساعة واحدة) : السعر الأساسي للإدخال × 2.0
• قراءة ذاكرة التخزين المؤقت (نجاح) : السعر الأساسي للإدخال × 0.1

هذا يعني أنه في كل مرة تنجح فيها قراءة ذاكرة التخزين المؤقت، تدفع فقط 10% من سعر الإدخال القياسي. على سبيل المثال، مع نموذج Claude Sonnet 4.6، يكون سعر الإدخال القياسي هو $3/MTok، بينما سعر نجاح ذاكرة التخزين المؤقت هو $0.3/MTok فقط، مما يوفر 90% من تكلفة الإدخال.

حساب استرداد التكلفة في فوترة ذاكرة التخزين المؤقت لـ Claude

من المهم جدًا فهم عائد التكلفة لاستخدام ذاكرة التخزين المؤقت. كتابة ذاكرة التخزين المؤقت لها تكلفة إضافية، لكن قراءتها رخيصة جدًا، النقطة الأساسية هي: بعد كم مرة نجاح تبدأ ذاكرة التخزين المؤقت في "استرداد التكلفة"؟

• ذاكرة تخزين مؤقت لمدة 5 دقائق: كتابة 1.25x + قراءة 0.1x = بعد الكتابة الأولى، يكفي نجاح مرة واحدة لاسترداد التكلفة (لأن القراءة العادية تكلف 1x، بينما قراءة ذاكرة التخزين المؤقت تكلف 0.1x، توفير 0.9x > الدفع الإضافي 0.25x)
• ذاكرة تخزين مؤقت لمدة ساعة واحدة: كتابة 2.0x + قراءة 0.1x = بعد الكتابة الأولى، تحتاج إلى نجاح مرتين لاسترداد التكلفة (دفع إضافي 1.0x، كل نجاح يوفر 0.9x)

لذا فإن ذاكرة التخزين المؤقت لمدة 5 دقائق هي خيار "مربح تقريبًا دائمًا"، بينما تحتاج ذاكرة التخزين المؤقت لمدة ساعة إلى ضمان نجاحها مرتين على الأقل خلال فترة صلاحيتها.

مقارنة فوترة ذاكرة التخزين المؤقت لـ Claude: 5 دقائق مقابل ساعة واحدة

الفرق في السعر بين ذاكرة التخزين المؤقت لمدة 5 دقائق وساعة واحدة

فيما يلي أسعار كتابة ذاكرة التخزين المؤقت لمدة 5 دقائق وساعة واحدة لكل نموذج كمثال:

استراتيجية اختيار TTL في فوترة ذاكرة التخزين المؤقت لـ Claude

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

حالات استخدام ذاكرة التخزين المؤقت لمدة 5 دقائق:

• مكالمات API عالية التردد (عدة طلبات في الدقيقة)، يتم تحديث ذاكرة التخزين المؤقت باستمرار خلال 5 دقائق
• سيناريوهات المحادثات التفاعلية، حيث يرسل المستخدم رسائل مستمرة، مما يجدد ذاكرة التخزين المؤقت تلقائيًا
• المشاريع الحساسة للتكلفة، حيث تكون رسوم الكتابة أقل

حالات استخدام ذاكرة التخزين المؤقت لمدة ساعة واحدة:

• مهام المعالجة المجمعة، حيث قد يتم تشغيل دفعة من البيانات كل بضع عشرات الدقائق
• توجيهات النظام الكبيرة، حيث تكون تكلفة الكتابة عالية، وتريد بقاء ذاكرة التخزين المؤقت لفترة أطول
• سيناريوهات المهام المجدولة، التي يتم تنفيذها كل 15-30 دقيقة

آلية مهمة: يتم تحديث TTL تلقائيًا في ذاكرة التخزين المؤقت لمدة 5 دقائق في كل مرة يتم فيها النجاح، أي "تجديد". لذلك، إذا كان تردد استدعائك مرتفعًا بما يكفي (طلب واحد على الأقل كل 5 دقائق)، يمكن أن تبقى ذاكرة التخزين المؤقت حية فعليًا دون الحاجة إلى اختيار ذاكرة التخزين المؤقت لمدة ساعة.

🎯 نصيحة تقنية: ذاكرة التخزين المؤقت لمدة 5 دقائق كافية في معظم السيناريوهات. عند استدعاء Claude API عبر منصة APIYI apiyi.com، تكون قواعد فوترة ذاكرة التخزين المؤقت متطابقة تمامًا مع الرسمية، وتدعم إدارة استراتيجيات ذاكرة التخزين المؤقت لعدة نماذج عبر واجهة موحدة.

استخدام TTL المختلط في فوترة ذاكرة التخزين المؤقت لـ Claude

يسمح Anthropic باستخدام نوعي التحكم في ذاكرة التخزين المؤقت (ساعة واحدة و5 دقائق) في نفس الطلب، لكن هناك قيد رئيسي:

ترتيب TTL من الأطول إلى الأقصر: يجب أن تظهر علامة ذاكرة التخزين المؤقت لمدة ساعة قبل علامة ذاكرة التخزين المؤقت لمدة 5 دقائق.

في التطبيق العملي، يمكنك تعيين توجيهات النظام ذات التردد المنخفض للتغيير على أنها ذاكرة تخزين مؤقت لمدة ساعة، وتعيين أمثلة Few-shot ذات التردد الأعلى قليلاً للتغيير على أنها ذاكرة تخزين مؤقت لمدة 5 دقائق:

import anthropic

client = anthropic.Anthropic(
    api_key="YOUR_API_KEY",
    base_url="https://vip.apiyi.com"  # الاستدعاء عبر APIYI
)

response = client.messages.create(
    model="claude-sonnet-4-6-20260320",
    max_tokens=1024,
    system=[
        {
            "type": "text",
            "text": "أنت مساعد وثائق تقنية محترف...(توجيهات نظام كثيرة)...",
            "cache_control": {"type": "ephemeral", "ttl": "3600"}  # ذاكرة تخزين مؤقت لمدة ساعة
        }
    ],
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "فيما يلي وثائق مرجعية...(سياق كبير)...",
                    "cache_control": {"type": "ephemeral"}  # ذاكرة تخزين مؤقت افتراضية لمدة 5 دقائق
                },
                {
                    "type": "text",
                    "text": "يرجى الإجابة بناءً على الوثائق المذكورة أعلاه: ما هو Prompt Caching؟"
                }
            ]
        }
    ]
)

import anthropic

client = anthropic.Anthropic(
    api_key="YOUR_API_KEY",
    base_url="https://vip.apiyi.com"
)

response = client.messages.create(
    model="claude-sonnet-4-6-20260320",
    max_tokens=1024,
    system=[
        {
            "type": "text",
            "text": "محتوى توجيهات النظام الخاصة بك (يجب أن يكون >= 1024 رمزًا لتفعيل ذاكرة التخزين المؤقت)",
            "cache_control": {"type": "ephemeral"}
        }
    ],
    messages=[{"role": "user", "content": "مرحبًا"}]
)

# التحقق من استخدام ذاكرة التخزين المؤقت
usage = response.usage
print(f"رموز الإدخال: {usage.input_tokens}")
print(f"رموز كتابة ذاكرة التخزين المؤقت: {usage.cache_creation_input_tokens}")
print(f"رموز نجاح ذاكرة التخزين المؤقت: {usage.cache_read_input_tokens}")

# تحديد حالة ذاكرة التخزين المؤقت
if usage.cache_read_input_tokens > 0:
    print("نجاح ذاكرة التخزين المؤقت! تم توفير 90% من تكلفة الإدخال")
elif usage.cache_creation_input_tokens > 0:
    print("كتابة أولية لذاكرة التخزين المؤقت، ستنجح الطلبات اللاحقة في ذاكرة التخزين المؤقت")

💡 ملاحظة: هناك حد أدنى مطلوب لعدد الرموز في ذاكرة التخزين المؤقت. يتطلب Claude Opus 4.6 على الأقل 1024 رمزًا، ويتطلب Sonnet 4.6 و Haiku 4.5 أيضًا على الأقل 1024 رمزًا. لن يتم تخزين المحتوى الذي يقل عن هذا الحد في ذاكرة التخزين المؤقت.

عزل ذاكرة التخزين المؤقت لـ Claude: آلية العزل عبر الحسابات

هذا هو السؤال الذي يشغل بال معظم المطورين: هل يمكن للحساب B استخدام ذاكرة التخزين المؤقت التي كتبها الحساب A؟

القاعدة الأساسية لعزل ذاكرة التخزين المؤقت لـ Claude

الجواب واضح: لا. ذاكرة التخزين المؤقت معزولة تمامًا بين المنظمات (Organizations) المختلفة.

بدءًا من 5 فبراير 2026، قامت Anthropic بتفصيل مستوى عزل ذاكرة التخزين المؤقت من "مستوى المنظمة" إلى "مستوى مساحة العمل (Workspace)". وهذا يعني:

التأثير العملي لعزل ذاكرة التخزين المؤقت لـ Claude

تحليل سيناريو: لنفترض أن لديك حسابين لـ Claude API (تابعين لمنظمتين مختلفتين)، وتقوم بتشغيل مجموعة من مهام معالجة البيانات في نفس الوقت.

• يرسل الحساب A طلبًا، مما يؤدي إلى كتابة في ذاكرة التخزين المؤقت ودفع تكلفة الكتابة (1.25x)
• يرسل الحساب B نفس الموجه تمامًا خلال 5 دقائق
• النتيجة: لن يستخدم الحساب B ذاكرة التخزين المؤقت للحساب A، بل سيقوم الحساب B أيضًا بكتابة جديدة في الذاكرة المؤقتة ويدفع 1.25x مرة أخرى

هذا التصميم مبني على اعتبارات الأمان والخصوصية – حيث قد تحتوي ذاكرة التخزين المؤقت على نصوص نظام (System Prompt) حساسة أو بيانات أعمال، ومشاركتها عبر المنظمات قد تشكل خطر تسرب البيانات.

استراتيجية التحسين: إذا كنت بحاجة إلى مشاركة ذاكرة التخزين المؤقت بين عدة خدمات لتقليل التكاليف، يجب وضع مفاتيح API الخاصة بها ضمن نفس مساحة العمل، وليس استخدام حسابات تابعة لمنظمات مختلفة.

🎯 نصيحة عملية: على منصة APIYI (apiyi.com)، يتم معالجة طلبات كل مستخدم عبر قناة مصدر موحدة. إذا كنت بحاجة إلى مشاركة ذاكرة التخزين المؤقت بين مشاريع متعددة، نوصي بالتخطيط المناسب لهيكل مساحات العمل في Anthropic Console، ووضع المشاريع التي تحتاج إلى مشاركة الذاكرة المؤقتة ضمن نفس مساحة العمل.

شروط استخدام ذاكرة التخزين المؤقت لـ Claude

بالإضافة إلى عزل مساحات العمل، هناك شرط أساسي آخر لاستخدام الذاكرة المؤقتة – يجب أن يكون الموجه (prompt) متطابقًا 100%.

يتم إنشاء مفتاح ذاكرة التخزين المؤقت (Cache Key) من خلال توليد تجزئة تشفيرية (hash) لمحتوى الموجه. نطاق المطابقة يشمل:

• tools (تعريفات الأدوات)
• system (نص النظام)
• messages (سجل المحادثة)

يتم دمج الأجزاء الثلاثة المذكورة أعلاه بالترتيب، حتى موضع علامة cache_control. إذا اختلف أي حرف (بما في ذلك المسافات وأحرف السطر الجديد)، فلن يتم استخدام الذاكرة المؤقتة.

مقارنة تسعير التخزين المؤقت بين Claude في AWS Bedrock وAnthropic الرسمي

الفروق في تسعير التخزين المؤقت بين AWS Bedrock وواجهة برمجة تطبيقات Anthropic الرسمية

تستخدم العديد من الشركات Claude عبر AWS Bedrock، حيث توجد الفروق التالية في تسعير التخزين المؤقت مقارنة بواجهة برمجة تطبيقات Anthropic الرسمية:

الفروق الرئيسية في تسعير التخزين المؤقت لـ Claude على AWS Bedrock

الفرق الأول: نطاق دعم النماذج للتخزين المؤقت لمدة ساعة

حتى يناير 2026، يدعم AWS Bedrock التخزين المؤقت لمدة ساعة (TTL) فقط لنماذج Claude Haiku 4.5 وSonnet 4.5 وOpus 4.5. قد لا تدعم أحدث الإصدارات مثل Opus 4.6 وSonnet 4.6 على Bedrock خيار التخزين المؤقت لمدة ساعة بعد. إذا كنت بحاجة إلى مزيج من أحدث النماذج والتخزين المؤقت لمدة ساعة، فمن المستحسن استخدام واجهة برمجة تطبيقات Anthropic الرسمية مباشرة.

الفرق الثاني: دقة عزل التخزين المؤقت

يحافظ AWS Bedrock على عزل التخزين المؤقت على مستوى المؤسسة (أي مستوى حساب AWS)، بينما دقت واجهة برمجة تطبيقات Anthropic الرسمية إلى مستوى مساحة العمل (Workspace). وهذا يعني أنه على Bedrock، يمكن لجميع الاستدعاءات ضمن نفس حساب AWS مشاركة التخزين المؤقت، مما يجعل الدقة أقل تفصيلاً مقارنة بواجهة برمجة التطبيقات الرسمية.

الفرق الثالث: اختلافات التسعير الإقليمي

قد تحمل نقاط النهاية الإقليمية لـ AWS Bedrock (مثل us-east-1 وeu-west-1) علاوة سعرية تصل إلى 10% مقارنة بنقاط النهاية العالمية. تنعكس هذه العلاوة أيضًا في تكاليف كتابة وقراءة التخزين المؤقت.

💰 نصيحة لتحسين التكلفة: إذا كنت تستخدم واجهة برمجة تطبيقات Claude بشكل أساسي ولديك متطلبات تحكم دقيقة في استراتيجية التخزين المؤقت، فإن استخدام واجهة برمجة تطبيقات Anthropic الأصلية عبر APIYI (apiyi.com) يعد خيارًا أكثر مرونة. تدعم المنصة نقل معلمات التحكم الكاملة في التخزين المؤقت، وتوفر أسعارًا أكثر تنافسية.

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

الخلاصة

النقاط الأساسية لفوترة ذاكرة التخزين المؤقت لـ Claude API:

1. تخزين مؤقت لمدة 5 دقائق بمعامل 1.25x، تخزين مؤقت لمدة ساعة بمعامل 2.0x: في معظم السيناريوهات، يكفي اختيار التخزين المؤقت لمدة 5 دقائق. في حالات الاستدعاء المتكرر، يتم تجديد التخزين المؤقت تلقائيًا، مما يعطي تأثيرًا مماثلاً للتخزين المؤقت طويل الأمد.
2. قراءة التخزين المؤقت فقط 0.1x: عند ضرب التخزين المؤقت، يتم توفير 90% من تكلفة المدخلات. يكفي ضرب التخزين المؤقت مرة واحدة خلال 5 دقائق لاسترداد التكلفة.
3. عزل التخزين المؤقت على مستوى مساحة العمل (Workspace): لا يمكن مشاركة التخزين المؤقت بين منظمات أو مساحات عمل مختلفة، مما يتطلب تخطيطًا مناسبًا لهيكل مساحة العمل.

للمطورين الذين يحتاجون إلى استدعاء Claude API بشكل مكثف، يمكن للاستخدام المناسب لاستراتيجية التخزين المؤقت أن يخفض التكاليف بشكل ملحوظ. نوصي باستخدام منصة APIYI apiyi.com لاستدعاء Claude API، حيث تدعم نقل معلمات التخزين المؤقت الكاملة، وإدارة واجهة موحدة، وتوفر رصيد اختبار مجاني لمساعدتك في التحقق من فعالية استراتيجية التخزين المؤقت.

المراجع

1. الوثائق الرسمية لـ Anthropic Prompt Caching: شرح كامل لوظيفة التخزين المؤقت لـ Claude API

   • الرابط: platform.claude.com/docs/en/build-with-claude/prompt-caching
   • الشرح: يتضمن معاملات التسعير الأساسية للتخزين المؤقت، إعداد TTL، متطلبات الحد الأدنى للرموز (tokens)، وغيرها.

2. صفحة تسعير Anthropic API: أحدث أسعار جميع نماذج Claude

   • الرابط: platform.claude.com/docs/en/about-claude/pricing
   • الشرح: يتضمن أسعار المدخلات/المخرجات الأساسية والتسعير التفصيلي لعمليات التخزين المؤقت.

3. وثائق AWS Bedrock Prompt Caching: دليل استخدام التخزين المؤقت لـ Claude على منصة AWS

   • الرابط: docs.aws.amazon.com/bedrock/latest/userguide/prompt-caching.html
   • الشرح: طرق تكوين التخزين المؤقت الخاصة بـ Bedrock وقائمة النماذج المدعومة.

4. إعلان AWS Bedrock للتخزين المؤقت لمدة ساعة: بيان إصدار وظيفة TTL للتخزين المؤقت لمدة ساعة

   • الرابط: aws.amazon.com/about-aws/whats-new/2026/01/amazon-bedrock-one-hour-duration-prompt-caching/
   • الشرح: نطاق النماذج المدعومة وطريقة استخدام التخزين المؤقت لمدة ساعة في Bedrock.

المؤلف: فريق APIYI التقني
التواصل التقني: نرحب بمناقشة قضايا فوترة التخزين المؤقت لـ Claude في قسم التعليقات. لمزيد من نصائح استخدام API، يمكنك زيارة مركز وثائق APIYI docs.apiyi.com.