API key

Crea, limita e ruota le chiavi con cui il tuo codice si autentica. Una chiave è l'unica credenziale di cui il gateway ha bisogno: la stessa chiave per ogni modello e ogni endpoint.

Nella barra laterale della console (appare quando la funzionalità si applica al tuo account): API keys Apri ↗

Passaggi

Apri API keys e premi Create key.
Assegnale un nome che riconoscerai anche tra sei mesi: è il nome che ti permette di distinguere le chiavi durante una rotazione.
Imposta i limiti che deve portare con sé: una quota di spesa con intervallo di reset, un elenco di modelli consentiti, una allowlist di IP e una data di scadenza. Sono tutti opzionali: una chiave senza nessuno di questi può chiamare qualsiasi modello a cui il tuo workspace ha accesso.
Copia subito la chiave e salvala nel tuo gestore di segreti. Poi inviala come Authorization: Bearer <key>.

Limiti e insidie

Una chiave viene mostrata una sola volta. Non esiste alcun modo per rivederla: se la perdi, eliminala e creane un'altra.
L'eliminazione di una chiave ha effetto immediato. Per ruotarla, crea la nuova chiave, distribuiscila e solo poi elimina la vecchia, in quest'ordine.
Le chiavi appartengono a un workspace. Cambiando workspace cambiano le chiavi che vedi, e una chiave non è mai valida al di fuori del proprio.
Una allowlist di IP è un elenco fisso impostato sulla chiave. Se preferisci approvare i nuovi indirizzi man mano che compaiono, attiva gli IP attendibili per il workspace; una chiave con allowlist continua a usare solo il proprio elenco.

Riferimento API per la stessa funzionalità: Chiavi API