> ## Documentation Index
> Fetch the complete documentation index at: https://veniceai-docs-revamp.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# الخصوصية

> كيف تتعامل Venice مع المطالبات والاستجابات والبيانات الوصفية و TEE وطلبات النماذج المُشفَّرة من طرف إلى طرف.

أحد المبادئ التوجيهية لـ Venice هو خصوصية المستخدم. تنبثق بنية المنصة من هذا المبدأ الفلسفي، وكل مكوّن مصمّم مع وضع هذا الهدف في الاعتبار.

> الطريقة الوحيدة لتحقيق خصوصية معقولة للمستخدم هي تجنب جمع هذه المعلومات في المقام الأول. هذا أصعب من منظور هندسي، لكننا نعتقد أنه النهج الصحيح.

تكرر Venice API نفس بنية الخصوصية في الواجهة الخلفية لمنصة Venice: تمر الطلبات عبر وكيل Venice على اتصالات مُشفَّرة، ولا تخزّن Venice أو تسجّل محتوى المطالبات والاستجابات للاستدلال العادي، ويضيف كل نموذج مختار أحد أربعة أوضاع خصوصية على طبقة وقت التشغيل: Anonymous أو Private أو TEE أو E2EE.

<img src="https://mintcdn.com/veniceai-docs-revamp/g8oXKfwfA1Z4HSGM/images/privacy-architecture.png?fit=max&auto=format&n=g8oXKfwfA1Z4HSGM&q=85&s=9fe37199bcabb2d2009f4e29e294bce1" alt="بنية خصوصية Venice AI" width="2042" height="812" data-path="images/privacy-architecture.png" />

## بنية الخصوصية

وكيل Venice هو الأساس المشترك لكل وضع خصوصية. تمر الطلبات عبر Venice عبر HTTPS/TLS ويتم تمريرها دون أن تخزّن Venice محتوى المطالبة أو الاستجابة. يحدد وضع الخصوصية على النموذج المختار ما يحدث بعد ذلك في طبقة المزود أو وقت تشغيل النموذج.

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

<div className="venice-privacy-level-label">حماية خصوصية متزايدة</div>

<div className="venice-privacy-mode-grid">
  <div className="venice-privacy-mode-card venice-privacy-mode-anonymous">
    <div className="venice-privacy-mode-header">
      <span className="venice-privacy-mode-name">Anonymous</span>
    </div>

    <h3>الهوية محجوبة عن المزود</h3>
    <p>تقوم Venice بتوجيه الطلب دون إرسال هويتك في Venice إلى مزود النموذج. لا يزال محتوى المطالبة مرئيًا لذلك المزود.</p>
  </div>

  <div className="venice-privacy-mode-card venice-privacy-mode-private">
    <div className="venice-privacy-mode-header">
      <span className="venice-privacy-mode-name">Private</span>
    </div>

    <h3>عدم الاحتفاظ بأي بيانات، مفروض تعاقديًا</h3>
    <p>يتم معالجة محتوى المطالبة والاستجابة للاستدلال فقط ولا يتم الاحتفاظ به بعد اكتمال الطلب.</p>
  </div>

  <div className="venice-privacy-mode-card venice-privacy-mode-tee">
    <div className="venice-privacy-mode-header">
      <span className="venice-privacy-mode-name">TEE</span>
    </div>

    <h3>استدلال معزول بالعتاد</h3>
    <p>تعمل النماذج المدعومة داخل بيئة تنفيذ موثوقة مع دعم التصديق عن بُعد.</p>
  </div>

  <div className="venice-privacy-mode-card venice-privacy-mode-e2ee">
    <div className="venice-privacy-mode-header">
      <span className="venice-privacy-mode-name">E2EE</span>
    </div>

    <h3>مُشفَّر من طرف إلى طرف إلى TEE موثوق</h3>
    <p>يقوم عميلك بتشفير المطالبة قبل إرسالها. تقوم Venice بتمرير النص المُشفَّر، ولا يفك تشفيره إلا TEE الموثوق.</p>
  </div>
</div>

تخبرك endpoint `/models` بمستوى خصوصية كل نموذج. النماذج المُعلَّمة بـ `anonymized` هي نماذج Anonymous، والنماذج المُعلَّمة بـ `private` هي نماذج Private. تُعرَض TEE و E2EE بشكل منفصل في قدرات النموذج، مثل `supportsTeeAttestation` و `supportsE2EE`.

<Info>
  لتفاصيل التنفيذ، راجع [دليل نماذج TEE و E2EE](/guides/features/tee-e2ee-models).
</Info>

## TEE و E2EE

تضيف نماذج TEE و E2EE ضوابط مُشفَّرة ومدعومة بالعتاد فوق نهج Venice الافتراضي بعدم الاحتفاظ بالمحتوى.

<CardGroup cols={2}>
  <Card title="استخدم TEE عندما" icon="shield-halved">
    تريد أن يعمل النموذج داخل enclave عتاد مُصدَّق، لكن عميلك يمكنه إرسال مطالبات بنص عادي عبر طلب API العادي.
  </Card>

  <Card title="استخدم E2EE عندما" icon="lock">
    تريد تشفير المطالبات قبل مغادرة عميلك وفك تشفيرها فقط داخل TEE موثوق.
  </Card>
</CardGroup>

يستخدم تدفق E2EE `/chat/completions` مع النماذج القادرة على E2EE. يجب على عميلك جلب التصديق، والتحقق من الـ nonce ودليل الـ enclave، وتشفير رسائل `user` و `system`، وإرسال رؤوس `X-Venice-TEE-*`، واستلام الاستجابة عبر streaming، والتحقق من محتوى الاستجابة وفك تشفيره.

يعطل E2EE أيضًا الميزات التي تحتاج إلى نص عادي خارج الـ enclave، مثل البحث في الويب، والذاكرة، والملخصات، وبعض تدفقات الأدوات، والمعالجة الأخرى من جانب الخادم.

## اختيار النموذج

استخدم `/models` لمعرفة حمايات الخصوصية التي يدعمها كل نموذج قبل إرسال طلب.

لكل نموذج حقلان ذو صلة:

* `model_spec.privacy` يخبرك بوضع الخصوصية الأساسي للنموذج:
  * `anonymized`: تخفي Venice هويتك عن المزود، لكن قد يظل المزود يرى المطالبة.
  * `private`: تقوم Venice بتوجيه الطلب عبر بنية تحتية لا تحتفظ بالبيانات.
* `model_spec.capabilities` يخبرك بما إذا كان النموذج يدعم حمايات أقوى:
  * `supportsTeeAttestation`: يمكن للنموذج العمل داخل بيئة تنفيذ موثوقة قابلة للتحقق.
  * `supportsE2EE`: يمكن للنموذج قبول مطالبات مُشفَّرة من العميل تُفك تشفيرها فقط داخل TEE.

E2EE هو تدفق يقوده العميل. يجب على تطبيقك تشفير الطلب، والتحقق من التصديق، والتحقق من الاستجابة وفك تشفيرها. راجع [دليل نماذج TEE و E2EE](/guides/features/tee-e2ee-models).

<CodeGroup>
  ```bash cURL theme={"dark"}
  curl https://api.venice.ai/api/v1/models \
    -H "Authorization: Bearer $API_KEY_VENICE" | \
    jq '.data[] | {
      id,
      privacy: .model_spec.privacy,
      tee: .model_spec.capabilities.supportsTeeAttestation,
      e2ee: .model_spec.capabilities.supportsE2EE
    }'
  ```
</CodeGroup>

قاعدة عامة بسيطة: اختر `private` لعدم الاحتفاظ بالبيانات، اختر `tee: true` للعزل المدعوم بالعتاد، واختر `e2ee: true` عندما تحتاج إلى مطالبات مُشفَّرة قبل مغادرة عميلك.

## البيانات الوصفية التشغيلية

قد تعالج Venice البيانات الوصفية اللازمة للمصادقة والفوترة ومنع الإساءة والموثوقية والتحليلات والدعم. بناءً على كيفية استخدامك للمنتج، يمكن أن يشمل ذلك معرّفات الحساب أو المحفظة، ومعرّفات مفاتيح API، وطوابع زمنية للطلب، والنموذج المختار، وعدد الـ tokens، ومبالغ الفوترة، وحالة حد المعدل، ومعرّفات الطلب، وعنوان IP، ومعلومات المتصفح أو الجهاز، وسجلات أحداث المنتج.

تُستخدَم هذه البيانات الوصفية لتشغيل API وهي منفصلة عن محتوى المطالبة والاستجابة. تتعقب سجلات الفوترة والاستخدام تفاصيل مثل النموذج، و endpoint، وعدد الـ tokens، والطوابع الزمنية، ومعرّفات الحساب؛ وهي لا تتطلب تخزين المطالبة أو الإكمال.
