File, immagini e audio

File privati

La superficie Files permette upload, metadati, lettura del contenuto e cancellazione dei file appartenenti al chiamante. Usa l’identificativo restituito nei protocolli che supportano quel tipo di allegato.

curl --fail-with-body https://api.llm.netter.io/v1/files \
  -H "Authorization: Bearer $NETTER_API_KEY" \
  -F purpose=assistants \
  -F file=@documento.txt

L’upload non rende pubblico il file e non dimostra che ogni modello possa interpretarlo. Le risorse conservano i confini di tenant e proprietà.

Documenti testuali

Il sistema estrae localmente testo UTF-8, PDF testuali e DOCX nel flusso previsto. La protezione PII opera sui campi testuali trattati. Un PDF senza livello testuale viene rifiutato come documento testuale; non viene sottoposto automaticamente a OCR.

Immagini

Un’immagine richiede un modello e un mapping vision compatibili con il formato del protocollo scelto: Chat Completions, Messages o Responses. I byte dell’immagine vengono inoltrati invariati e non sono anonimizzati.

La disponibilità di un modello vision va verificata specificamente: non deriva dalla presenza del modello nel catalogo testuale.

Audio

Operazione	Endpoint	Base di tariffazione prevista
Trascrizione	/v1/audio/transcriptions	Durata audio verificata localmente
Traduzione	/v1/audio/translations	Durata audio verificata localmente
Sintesi vocale	/v1/audio/speech	Caratteri del testo secondo il mapping

L’audio non viene anonimizzato. Con PII attivo, un testo TTS nel quale sono riconosciuti dati personali viene rifiutato prima dell’invio: quei valori non possono essere ripristinati nell’audio remoto senza sintetizzarli di nuovo.

Limiti

Superficie	Limite documentato
File API	20 MB
Upload portale	32 MB
ZIP consulenza	5.000 file, 64 MB espansi, 4 MB per file
Percorsi ZIP	Niente symlink o percorsi fuori archivio

Si applicano inoltre limiti di contesto e output del singolo mapping e i controlli di dimensione della richiesta. Non aggirare un limite spezzando contenuti che devono restare coerenti per il modello.

Prima di inviare media consulta Privacy e il contratto API.