Porta la tua chiave AI
Le funzionalità AI sono costruite su un principio: tu porti la tua chiave del provider e la tua chiave rimane lato server. Non sei mai vincolato a un singolo modello e non paghi mai all'app un sovrapprezzo rispetto al prezzo del provider.
Come funziona
Colleghi una chiave API per un provider che già utilizzi: OpenAI, Anthropic, Google, Qwen, DeepSeek, Kimi, GLM, o un endpoint personalizzato compatibile con OpenAI per la chat, più BytePlus e fal.ai per immagini e video. Quando usi AI Studio nell'area di lavoro, l'app chiama quel provider per tuo conto dal server, quindi la tua chiave non raggiunge mai la pagina. L'assistente nell'editor funziona diversamente: mantiene la tua chiave nel browser e chiama direttamente il provider da lì. In entrambi i casi, vieni fatturato direttamente dal provider per ciò che usi, alle tariffe del provider, e puoi cambiare provider in qualsiasi momento.
| Passo | Dettaglio |
|---|---|
| Collega | Aggiungi una chiave del provider nelle impostazioni AI |
| Testa | Conferma che la chiave funzioni prima di farvi affidamento |
| Usa | Chat, generazione di immagini e video |
| Cambia | Cambia provider per attività, quando vuoi, con ogni chiave che ricorda il proprio modello e le proprie impostazioni |
Le tue chiavi sono protette
Tratta le chiavi del provider come password
In AI Studio, le tue chiavi API sono crittografate a riposo e non vengono mai restituite al browser, e tutte le chiamate al provider passano attraverso il server, quindi la tua chiave non è esposta alla pagina né ad altri utenti. Due cose funzionano diversamente: un endpoint personalizzato non ha un proxy server incorporato, quindi quelle richieste vanno direttamente dal tuo browser all'indirizzo che fornisci; e l'assistente nell'editor mantiene la tua chiave nel browser e chiama i provider direttamente invece che attraverso il server. Considera entrambi come motivi per connettere una chiave solo su un dispositivo di cui ti fidi.
Cosa necessita di una chiave
| Funzionalità | Chiave |
|---|---|
| Chat, generazione di immagini e video | La tua chiave del provider AI |
| Skills e skill kit | Utilizzano la chiave del provider attivo, nessuna chiave separata propria |
| Ricerca di contenuti stock | Le tue chiavi del provider di stock, separate dalla tua chiave AI |
Colleghi provider e chiavi nelle impostazioni AI. Per la configurazione completa, vedi AI Studio e la matrice provider e modelli per ciò che ciascuno copre.
Ottenere una chiave
Ogni provider emette chiavi dalla propria console sviluppatore o sito di piattaforma, completamente al di fuori dell'app; ti registri direttamente lì e copi una chiave nelle impostazioni AI. La maggior parte dei provider offre un livello gratuito o di prova per iniziare, prima di dover aggiungere la fatturazione dalla loro parte.
Passo dopo passo: collegare la tua prima chiave del provider
- Ottieni una chiave API dal sito di un provider di chat: OpenAI, Anthropic, Google, Qwen, DeepSeek, Kimi o GLM vanno bene, oppure punta a un endpoint compatibile con OpenAI che già gestisci.
- Apri le impostazioni AI dal menu del tuo account e aggiungi la chiave sotto quel provider.
- Usa l'azione test connessione accanto alla chiave prima di farvi affidamento. Questa effettua una chiamata piccola ed economica al provider usando la tua chiave interamente sul server, così scopri immediatamente se la chiave è sbagliata invece di scoprirlo a metà generazione. Un paio di provider usati solo per immagini o video non hanno un endpoint leggero per testare; per quelli, il salvataggio con successo è la conferma.
- Apri AI Studio o l'assistente nell'editor e avvia una chat; utilizza il provider e il modello che hai selezionato l'ultima volta per quella conversazione.
- Se desideri anche la generazione di immagini o video, aggiungi una chiave per un provider di immagini e video separatamente dal tuo provider di chat; vengono collegati allo stesso modo ma sono fatturati e configurati autonomamente.
Operazioni comuni
- Cambiare provider a metà attività. Modifica il provider e il modello attivo dal compositore della chat in qualsiasi momento; ogni provider mantiene il proprio ultimo modello e le proprie impostazioni, quindi tornare indietro più tardi riprende da dove avevi lasciato con quel provider.
- Puntare a un modello self-hosted o locale. Aggiungilo come endpoint personalizzato con il suo URL base e la chiave. Se quell'endpoint è un indirizzo locale anziché un https pubblico, le richieste vanno direttamente dal tuo browser ad esso anziché attraverso il server, cosa prevista per qualcosa in esecuzione sulla tua macchina. Un endpoint personalizzato raggiungibile solo tramite https da un host pubblico potrebbe non funzionare attraverso il proxy server oggi; se un endpoint personalizzato ospitato non si connette, questa è probabilmente la ragione: usa un provider di chat dalla lista principale quando possibile.
- Usare chiavi diverse per diversi tipi di generazione. Chat, immagini e video leggono ciascuno dal proprio provider collegato; non è richiesto usare la stessa azienda per tutti e tre, scegli il più potente o economico per ciascuno.
- Anteprima del costo prima di generare video. Il flusso di generazione video mostra un costo stimato, basato sulla tariffa al secondo o per modello del tuo provider e sulla durata scelta, prima di confermare l'esecuzione. Vedi Generazione video.
Risoluzione dei problemi
- Una chiave appena aggiunta viene mostrata come non valida. Ricontrolla di aver copiato l'intera chiave senza spazi finali e che sia attiva sul dashboard del provider, non solo creata. Usa l'azione di test connessione per confermare prima di incolpare l'app.
- La generazione fallisce a metà con un errore del provider. Questo è quasi sempre colpa del provider stesso: un limite di velocità, una chiave scaduta o una fatturazione insufficiente impostata dalla loro parte, non qualcosa che l'app può aggirare. Controlla il dashboard di quel provider per l'utilizzo e lo stato della fatturazione.
- Un modello che ti aspettavi di vedere non è offerto. I modelli disponibili variano per provider, e il supporto per la visione (comprensione delle immagini) è limitato a modelli specifici all'interno di un provider. Vedi la matrice provider e modelli per ciò che ogni provider espone attualmente.
- Un endpoint personalizzato tramite https da un host pubblico non risponde. Il proxy lato server inoltra solo a un elenco fisso di provider noti per sicurezza; un endpoint https pubblico arbitrario non è automaticamente incluso in quell'elenco. Un endpoint locale, non https, è il caso supportato per endpoint personalizzato: si connette direttamente dal tuo browser invece.
Perché portare la propria chiave
Una chiave gestita significherebbe che l'app assorbe e maggiora ogni token, immagine e secondo di video che generi, e ti lega a qualsiasi modello la piattaforma scelga di offrire. Portare la propria chiave significa che i tuoi costi AI scalano con il tuo utilizzo effettivo al prezzo reale del tuo provider, e puoi aggiungere un nuovo provider il giorno in cui ti diventa utile anziché aspettare che la piattaforma lo aggiunga.
AI gestita
Un'opzione gestita, in cui la piattaforma fornisce AI senza che tu porti una chiave, è in programma. Oggi, AI funziona interamente con la tua chiave. Vedi la Roadmap.