الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

​
نظرة عامة

يقوم TokenLab بإدارة التخزين المؤقت تلقائيًا لتحسين الأداء وتقليل التكاليف. على الرغم من عدم وجود نقطة نهاية (endpoint) عامة لمسح إدخالات التخزين المؤقت، إلا أن لديك تحكمًا كاملاً في سلوك التخزين المؤقت من خلال عناصر التحكم على مستوى الطلب. هذه الصفحة هي دليل للتخزين المؤقت من جهة الطلب. لصفحات مرجعية API الصارمة، راجع:

​
تجاوز التخزين المؤقت

للحصول على استجابات جديدة دون استخدام التخزين المؤقت، استخدم المعلمة cache_control في طلبك: 
curl -X POST "https://api.tokenlab.sh/v1/chat/completions" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hello!"}],
    "cache_control": {"type": "no_cache"}
  }'

​
خيارات التحكم في التخزين المؤقت

النوعالتأثير
no_cacheيتخطى البحث والكتابة في التخزين المؤقت، ويحصل دائمًا على استجابة جديدة
no_storeعدم تخزين هذه الاستجابة في التخزين المؤقت
response_onlyاستخدام التخزين المؤقت للمطابقة التامة فقط (تخطي البحث الدلالي)
semantic_onlyاستخدام التخزين المؤقت الدلالي فقط (تخطي المطابقة التامة)

​
ملاحظات التخزين المؤقت

إذا تلقيت استجابة مخزنة مؤقتًا غير صحيحة، يمكنك الإبلاغ عنها: استخدم معرّف request/cache entry الناتج عن cache hit داخل مؤسستك؛ يتم رفض المعرّفات العشوائية. 
curl -X POST "https://api.tokenlab.sh/v1/cache/feedback" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "cache_entry_id": "req_1234567890",
    "feedback_type": "wrong_answer",
    "description": "Response was outdated"
  }'
عندما يتلقى إدخال التخزين المؤقت قدرًا كافيًا من الملاحظات السلبية، يتم إبطال مفعوله تلقائيًا.

​
حالات الاستخدام

أثناء التطوير، استخدم cache_control: {"type": "no_cache"} للتأكد من حصولك على استجابات API جديدة.
بالنسبة للبيانات في الوقت الفعلي مثل أسعار الأسهم أو الطقس، استخدم دائمًا no_cache للحصول على المعلومات الحالية.
عند تصحيح أخطاء الاستجابات غير المتوقعة، استخدم no_cache لاستبعاد النتائج المخزنة مؤقتًا.
لمزيد من التفاصيل حول التخزين المؤقت، راجع دليل التخزين المؤقت.