> ## 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.

# Privacy

> Come Venice gestisce prompt, risposte, metadati, TEE e richieste a modelli con crittografia end-to-end.

Uno dei principi guida di Venice è la privacy dell'utente. L'architettura della piattaforma deriva da questo principio filosofico e ogni componente è progettato con questo obiettivo in mente.

> L'unico modo per ottenere una privacy utente ragionevole è evitare di raccogliere queste informazioni in primo luogo. È più difficile dal punto di vista ingegneristico, ma riteniamo sia l'approccio corretto.

L'API Venice replica la stessa architettura di privacy backend della piattaforma Venice: le richieste passano attraverso il proxy Venice su connessioni cifrate, Venice non memorizza né registra il contenuto di prompt e risposte per l'inferenza normale e ciascun modello selezionato aggiunge una delle quattro modalità di privacy al livello di runtime: Anonymous, Private, TEE o 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 Privacy Architecture" width="2042" height="812" data-path="images/privacy-architecture.png" />

## Architettura di privacy

Il proxy Venice è la base condivisa per ogni modalità di privacy. Le richieste passano attraverso Venice via HTTPS/TLS e vengono inoltrate senza che Venice memorizzi il contenuto di prompt o risposte. La modalità di privacy sul modello selezionato determina cosa accade successivamente a livello di provider o di runtime del modello.

Venice presenta la privacy dei modelli in quattro modalità. Si basano sulla stessa fondazione di proxy e aggiungono protezioni progressivamente più forti, dall'oscurare l'identità al provider fino a cifrare i prompt end-to-end verso un enclave verificato.

<div className="venice-privacy-level-label">Protezione della privacy crescente</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>Identità nascosta al provider</h3>
    <p>Venice inoltra la richiesta senza inviare la tua identità Venice al provider del modello. Il contenuto del prompt rimane visibile a quel provider.</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>Zero data retention, garantita contrattualmente</h3>
    <p>Il contenuto di prompt e risposte viene elaborato solo per l'inferenza e non viene conservato dopo il completamento della richiesta.</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>Inferenza isolata via hardware</h3>
    <p>I modelli supportati vengono eseguiti all'interno di un Trusted Execution Environment con supporto alla remote attestation.</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>Crittografia end-to-end verso un TEE verificato</h3>
    <p>Il tuo client cifra il prompt prima di inviarlo. Venice inoltra il ciphertext e solo il TEE verificato lo decifra.</p>
  </div>
</div>

L'endpoint `/models` ti indica il livello di privacy di ciascun modello. I modelli contrassegnati come `anonymized` sono modelli Anonymous e quelli contrassegnati come `private` sono modelli Private. TEE ed E2EE vengono mostrati separatamente nelle capacità del modello, come `supportsTeeAttestation` e `supportsE2EE`.

<Info>
  Per i dettagli di implementazione, consulta la [guida ai modelli TEE & E2EE](/guides/features/tee-e2ee-models).
</Info>

## TEE ed E2EE

I modelli TEE ed E2EE aggiungono controlli crittografici e supportati da hardware oltre all'approccio predefinito di Venice di non conservare i contenuti.

<CardGroup cols={2}>
  <Card title="Usa TEE quando" icon="shield-halved">
    Vuoi che il modello venga eseguito all'interno di un enclave hardware attestato, ma il tuo client può inviare i prompt in chiaro sulla normale richiesta API.
  </Card>

  <Card title="Usa E2EE quando" icon="lock">
    Vuoi che i prompt siano cifrati prima di lasciare il tuo client e decifrati solo all'interno di un TEE verificato.
  </Card>
</CardGroup>

Il flusso E2EE usa `/chat/completions` con modelli abilitati a E2EE. Il tuo client deve recuperare l'attestation, verificare il nonce e l'evidenza dell'enclave, cifrare i messaggi `user` e `system`, inviare gli header `X-Venice-TEE-*`, eseguire lo streaming della risposta e verificare/decifrare il contenuto della risposta.

E2EE disabilita anche le funzionalità che richiedono testo in chiaro al di fuori dell'enclave, come web search, memoria, riassunti, alcuni flussi di tool e altre elaborazioni lato server.

## Scegliere un modello

Usa `/models` per vedere quali protezioni di privacy supporta ciascun modello prima di inviare una richiesta.

Ogni modello ha due campi rilevanti:

* `model_spec.privacy` indica la modalità di privacy di base del modello:
  * `anonymized`: Venice nasconde la tua identità al provider, ma il provider può comunque vedere il prompt.
  * `private`: Venice instrada la richiesta tramite infrastruttura zero-data-retention.
* `model_spec.capabilities` indica se il modello supporta protezioni più forti:
  * `supportsTeeAttestation`: il modello può essere eseguito all'interno di un Trusted Execution Environment verificabile.
  * `supportsE2EE`: il modello può accettare prompt cifrati dal client che vengono decifrati solo all'interno del TEE.

E2EE è un flusso guidato dal client. La tua applicazione deve cifrare la richiesta, verificare l'attestation e verificare/decifrare la risposta. Consulta la [guida ai modelli 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>

Una semplice regola pratica: scegli `private` per zero data retention, scegli `tee: true` per l'isolamento basato su hardware e scegli `e2ee: true` quando hai bisogno che i prompt siano cifrati prima di lasciare il tuo client.

## Metadati operativi

Venice può elaborare metadati necessari per autenticazione, fatturazione, prevenzione degli abusi, affidabilità, analytics e supporto. A seconda di come usi il prodotto, questi possono includere identificatori di account o wallet, identificatori di API key, timestamp delle richieste, modello selezionato, conteggi di token, importi di fatturazione, stato dei rate limit, ID di richiesta, indirizzo IP, informazioni sul browser o sul dispositivo e log di eventi di prodotto.

Questi metadati vengono utilizzati per gestire l'API e sono separati dal contenuto di prompt e risposte. I record di fatturazione e utilizzo tracciano dettagli come modello, endpoint, conteggi di token, timestamp e identificatori di account; non richiedono di memorizzare il prompt o il completamento.