Bring Your Own Key (BYOK)

Bring Your Own Key (BYOK) è una funzionalità riservata alle aziende che consente alla vostra organizzazione di collegare una chiave API di Google Gemini direttamente a i1n. Le traduzioni IA vengono quindi eseguite tramite il vostro account Google AI anziché utilizzare il pool di inferenza condiviso di i1n.

Quando BYOK è attivo, il tuo contratto Enterprise riceve un bonus del +50% sui crediti di traduzione AI e sulle chiavi di traduzione, oltre ai limiti già concordati. I costi di inferenza addebitati da Google vengono fatturati direttamente sul tuo account Google; i1n continua a gestire l'orchestrazione, la memorizzazione nella cache, la protezione delle variabili e l'applicazione del tono di voce del brand.

Il BYOK viene configurato per ogni organizzazione dalla dashboard. La chiave è crittografata a riposo e viene utilizzata solo per effettuare chiamate di traduzione per tuo conto; non viene mai registrata, esportata o condivisa tra le organizzazioni.

Vale la pena abilitare BYOK quando si verifica una delle seguenti condizioni: la tua organizzazione ha già un accordo con Google Cloud o Google AI Studio, richiedi una visibilità diretta dei costi sull'inferenza sottostante o desideri un accesso privilegiato ai modelli Gemini in anteprima non appena Google li rilascia.

Il bonus del +50% su crediti e chiavi significa che un tenant Enterprise con BYOK abilitato paga effettivamente solo per l'orchestrazione, mentre i costi di inferenza vengono gestiti tramite il rapporto di fatturazione Google esistente, il che solitamente si traduce in un costo totale di proprietà inferiore con volumi di traduzione elevati.

BYOK offre anche una governance più rigorosa. È possibile ruotare la chiave, impostare quote in Google AI Studio e controllare l'utilizzo da un'unica dashboard di fatturazione Google, insieme al resto dei carichi di lavoro AI.

Una volta abilitato BYOK, è possibile scegliere il modello Gemini predefinito utilizzato per la traduzione tramite IA. Il modello può essere modificato in qualsiasi momento dalla dashboard e si applica ai lavori di traduzione successivi.

Gemini 2.5 Flash-Lite è l'impostazione predefinita consigliata. Offre il miglior equilibrio tra qualità di traduzione, latenza e costi per la maggior parte dei carichi di lavoro di localizzazione.

Gemini 3 Flash (anteprima) è adatto per traduzioni generali di qualità superiore quando la latenza rimane una priorità. Gemini 3.1 Pro (anteprima) offre la massima qualità disponibile ed è consigliato per contenuti ricchi di sfumature o critici. Gemini 3.1 Flash-Lite (anteprima) è l'opzione più veloce ed è ideale per lotti molto grandi in cui il throughput è l'aspetto più importante.

I modelli in anteprima sono soggetti a modifiche da parte di Google. i1n tiene traccia delle nuove versioni di Gemini e le rende disponibili nella dashboard non appena vengono rilasciate; non è necessario alcun emendamento contrattuale per cambiare modello.

Passaggio 1 — Genera una chiave API Gemini. Accedi a Google AI Studio (aistudio.google.com), apri le chiavi API e crea una nuova chiave associata al progetto che desideri utilizzare per la fatturazione.

Passaggio 2 — Aggiungi la chiave a i1n. Dalla dashboard, apri le impostazioni dell'organizzazione, vai alla sezione BYOK, incolla la chiave API e salva. La chiave viene crittografata a riposo immediatamente dopo l'invio.

Passaggio 3 — Scegli il tuo modello predefinito. Seleziona uno dei modelli Gemini disponibili (vedi Modelli disponibili sopra). La selezione avrà effetto su tutti i successivi lavori di traduzione tramite CLI, server MCP e dashboard.

Passaggio 4 — Verifica. Esegui i1n push --translate su un piccolo set di chiavi e conferma che il processo venga completato. La vista di utilizzo della dashboard mostra se ogni traduzione è stata elaborata tramite BYOK o tramite il percorso di inferenza predefinito di i1n.

Per ruotare la chiave, sostituiscila nella dashboard in qualsiasi momento: i lavori in corso continueranno a utilizzare la chiave precedente fino al loro completamento. Per disabilitare completamente il BYOK, rimuovi la chiave dalla dashboard; le traduzioni future torneranno automaticamente al percorso di inferenza predefinito di i1n.