Collegare un provider

AI Studio funziona con la chiave del tuo provider, collegata da Settings, AI Settings, nella scheda Provider & Model. Prima di poter chattare o generare, collega almeno un provider. Vedi Usa la tua chiave AI per l'idea alla base di tutto questo.

Panoramica rapida

1. Apri Settings, AI Settings e scegli una scheda provider.
2. Incolla la tua chiave API.
3. Scegli un modello dall'elenco di quel provider.
4. Imposta un livello di ragionamento e, se vuoi, un prompt di sistema, la temperatura e il numero massimo di token.
5. Prova la connessione, poi attiva il provider per la chat.

Il flusso di configurazione

Per ogni provider i passaggi sono gli stessi tre campi, più le impostazioni avanzate facoltative.

Passaggio	Dettaglio
API key	Un campo mascherato come una password. Una volta salvata, viene mostrata solo come un breve suggerimento, mai il valore completo
Model	Un menu a discesa dei modelli disponibili di quel provider
Reasoning effort	Un insieme di livelli specifico del provider, mostrato solo per i provider abilitati alla chat
Test	Invia una piccola richiesta per confermare che la chiave funziona prima di farci affidamento
Use for chat	Un interruttore che rende questo il provider attivo per la chat

Le opzioni di livello di ragionamento variano da provider a provider, per esempio Default, Low, Medium, High e talvolta Extra High o Max sui provider che supportano un ragionamento più approfondito; un provider senza questa capacità salta del tutto il controllo. Il valore si applica automaticamente a ogni richiesta di chat su quel provider, nel compositore non c'è un interruttore per singolo messaggio.

La schermata delle impostazioni a colpo d'occhio

La scheda Provider & Model mostra sulla sinistra un elenco di tutti i provider. Un'icona a scudo contrassegna ogni provider che ha già una chiave salvata, e quello che alimenta la chat in questo momento è etichettato Active. Una striscia riepilogativa in alto ti dice sempre quale provider e quale modello sta usando la chat proprio ora, e se è collegata una chiave, così puoi verificare la tua configurazione senza aprire un pannello.

Fai clic su un provider in quell'elenco per aprirne il pannello sulla destra, disposto come tre passaggi numerati:

1. API Key, un campo mascherato. Una volta salvato, si riduce a un pulsante Change e a un controllo di eliminazione (cestino), e non mostra mai più la chiave completa.
2. Model, un menu a discesa dei modelli di quel provider, con l'impostazione predefinita sensata contrassegnata come recommended.
3. Try it, il pulsante Test connection.

Se il provider supporta un ragionamento regolabile, un piccolo menu a discesa Reasoning in linea si trova tra il passaggio 2 e il passaggio 3. Sotto i tre passaggi, una sezione a fisarmonica Advanced (optional) contiene le impostazioni più fini. Per attivare un provider per la chat si usa l'interruttore Use for chat: non puoi disattivarlo direttamente mentre quel provider è quello attivo, devi invece attivare un provider diverso, che riceve automaticamente l'etichetta Active.

Opzioni avanzate

Una sezione facoltativa e ripiegata aggiunge un controllo più fine.

Impostazione	Intervallo	Note
System prompt	Testo libero	Istruzioni personalizzate applicate sotto ogni risposta
Temperature	Da 0 a 1.5	Etichettata Precise, Balanced o Creative mentre sposti il cursore
Max tokens	Da 256 a 16384	Predefinito 2048. Limita la lunghezza massima di una singola risposta

Ogni campo avanzato si salva da solo nel momento in cui fai clic fuori da esso (alla perdita del focus), con un piccolo toast di conferma, quindi per questi tre non c'è un pulsante Save separato. Una volta collegata, la tua chiave viene mostrata mascherata, e puoi modificarla o eliminarla in qualsiasi momento. Puoi collegare quanti provider vuoi contemporaneamente, ognuno mantiene in modo indipendente la propria chiave, il proprio modello e il proprio livello di ragionamento, così non c'è nulla da riconfigurare quando cambi quale è attivo.

Livelli di ragionamento per provider

L'insieme esatto dei livelli varia da provider a provider, alcuni si spingono oltre di altri.

Provider	Livelli
OpenAI	Default, Off, Low, Medium, High, Extra High
Anthropic Claude	Default, Low, Medium, High, Extra High, Max
DeepSeek	Default, Off, High, Max (nessun livello Low o Medium)
Qwen	Default (off, recommended), Low, Medium, High
Kimi	Default, Off, On (un semplice on o off, senza livelli graduati)
GLM	Default, Off, On; un modello GLM di fascia più alta sblocca inoltre Low, High e Max oltre al semplice on o off
Google Gemini	Default, Minimal, Low, Medium, High

Un provider del tutto privo di un controllo del ragionamento, per esempio uno che non supporta un impegno regolabile, salta semplicemente questo campo.

Passo dopo passo

La schermata ha lo stesso aspetto per ogni provider, quindi una volta fatto la prima volta il resto è rapido. Queste guide usano clic e posizioni esatti.

Collegare una chiave OpenAI e prepararsi a chattare

1. Apri Settings, AI Settings e resta sulla scheda Provider & Model.
2. Nell'elenco dei provider a sinistra, fai clic su OpenAI. Il suo pannello si apre sulla destra.
3. Sotto Step 1, API Key, incolla la tua chiave nel campo mascherato. Se non ne hai ancora una, usa il piccolo link esterno accanto al nome del provider per aprire la console per sviluppatori di OpenAI e creare una chiave nella sua pagina delle chiavi API, poi torna qui e incollala. Fai clic su Save.
4. Sotto Step 2, Model, scegli un modello dal menu a discesa, oppure lascia quello già contrassegnato come recommended.
5. Se tra il passaggio 2 e il passaggio 3 compare un menu a discesa Reasoning, scegli un livello o lascialo su Default.
6. Sotto Step 3, Try it, fai clic su Test connection e attendi il messaggio "Connection successful, key is valid."
7. Attiva l'interruttore Use for chat se OpenAI non è già etichettato come Active. Così diventa il provider usato dalla chat.
8. Facoltativo: apri la sezione a fisarmonica Advanced (optional) per aggiungere istruzioni per l'assistente (un prompt di sistema), regolare la Creativity (temperatura) o limitare la lunghezza massima della risposta. Ognuno di quei campi si salva da solo quando fai clic altrove, quindi non c'è nient'altro da premere.

Configurare un provider solo video come fal.ai

1. Apri Settings, AI Settings, scheda Provider & Model, e fai clic su fal.ai nell'elenco a sinistra.
2. Incolla la tua chiave fal.ai (formattata come un id di chiave e un segreto uniti da due punti) nel campo API Key e fai clic su Save. La ottieni dalla pagina Keys della dashboard di fal.ai, raggiungibile dal link esterno accanto al nome del provider.
3. Nota che qui non c'è un menu a discesa dei modelli né un interruttore Use for chat. fal.ai è un motore di generazione, quindi la sua card mostra invece un badge Video engine, e spiega che il modello vero e proprio si sceglie più tardi, al momento della generazione.
4. Facendo clic su Test restituisce "Key saved (this provider has no live test)" anziché convalidarla davvero, perché questo provider non ha un endpoint economico da interpellare. È previsto, non è un errore.
5. Scegli il modello quando generi: nella modalità Video del compositore (Seedance 2.0, Seedance 2.0 Fast, Veo 3.1, Veo 3.1 Fast o Kling 2.6), oppure dentro Marketing Studio. Vedi Generare video per i controlli della modalità. BytePlus funziona allo stesso modo, con un badge Video + image engine, e sceglie anch'esso il modello al momento della generazione.

Cambiare il provider di chat attivo senza perdere le altre chiavi

1. Apri Settings, AI Settings, scheda Provider & Model.
2. Nell'elenco a sinistra, fai clic su un provider diverso che ha già una chiave salvata, indicato da un'icona a scudo.
3. Attiva il suo interruttore Use for chat. Diventa subito il provider di chat Active, e quello precedente perde da solo l'etichetta Active (non disattivi mai a mano quello vecchio).

Ogni altro provider mantiene salvati la sua chiave, il suo modello scelto e il suo livello di ragionamento, quindi tornare a uno di essi più tardi non richiede alcuna riconfigurazione. Non perdi nulla di ciò che hai collegato cambiando quale è attivo.

Collegare un endpoint self-hosted o personalizzato compatibile con OpenAI

1. Apri Settings, AI Settings, scheda Provider & Model, e fai clic su Custom Endpoint nell'elenco.
2. Inserisci un Base URL e un Model Name invece di scegliere da un menu a discesa di modelli fissi.
3. Qui non c'è un Test connection dal vivo: l'area del pulsante riporta invece "No test for a custom provider, try it in chat". Invia un messaggio in chat per confermare che funziona.
4. Attiva Use for chat per renderlo attivo.

Un endpoint personalizzato è l'unico provider la cui chiave non è cifrata sul server e non passa da un proxy, perché non c'è un host fisso attraverso cui instradare. La sua chiave resta nel tuo browser e le richieste vanno direttamente dal browser al Base URL che hai digitato, quindi usa solo un endpoint di cui ti fidi. È lo stesso comportamento indicato più sotto in Endpoint personalizzato.

Le tue chiavi sono al sicuro

Le chiavi sono memorizzate sul server

La tua chiave è cifrata a riposo sul server e non viene mai rispedita al browser. Ogni chiamata al provider viene effettuata dal server per tuo conto, così la pagina stessa non contiene mai la tua chiave reale, ma solo un segnaposto al suo posto.

Non tutti i provider possono essere testati dal vivo

Test Connection effettua una richiesta reale per la maggior parte dei provider. Un paio di provider solo video non espongono un endpoint adatto a un test dal vivo, quindi salvare lì la chiave conferma solo che è stata memorizzata, non che funziona.

Quali provider

Provider diversi supportano cose diverse: alcuni alimentano solo la chat, alcuni generano solo immagini o video, e un paio fanno entrambe le cose. Vedi la Matrice provider e modelli per il dettaglio completo per modalità.

Endpoint personalizzato

Se il tuo provider parla il formato chat completions compatibile con OpenAI, collegalo come Custom Endpoint indicando un Base URL e un Model Name invece di scegliere da un elenco fisso. È il modo per usare un modello self-hosted o un provider meno diffuso.

Gli endpoint personalizzati saltano il proxy del server

I provider con nome vengono chiamati dal server, quindi il tuo browser non comunica mai direttamente con loro. Un endpoint personalizzato è l'unica eccezione: poiché non esiste una route proxy integrata per un URL arbitrario, le richieste verso di esso vengono inviate direttamente dal tuo browser all'indirizzo che fornisci, e la sua chiave resta nel browser anziché essere cifrata sul server.

Cambiare o rimuovere una chiave

Torna alla stessa scheda provider in qualsiasi momento per incollare una nuova chiave sopra quella vecchia, o per eliminarla del tutto. Eliminare una chiave non elimina i modelli o le conversazioni che hai già usato con essa, interrompe soltanto la possibilità di usare quel provider finché non aggiungi di nuovo una chiave. Se il provider che elimini era il provider di chat attivo, attiva un provider collegato diverso prima di tornare a chattare.

Se una chiave non funziona

Un Test Connection fallito significa quasi sempre una di poche cose: la chiave è stata digitata male o ha spazi vuoti finali, la chiave appartiene a un prodotto diverso della stessa azienda, oppure l'account dietro la chiave non ha ancora una quota o una fatturazione configurate dal lato del provider. Il messaggio di errore restituito dal provider viene mostrato così com'è, quindi controllalo prima di dare la colpa all'app.

Risoluzione dei problemi

Il livello di ragionamento si azzera su un nuovo browser o dispositivo

A differenza della tua chiave API, che è cifrata e memorizzata sul server così ti segue su qualsiasi dispositivo da cui accedi, il livello di ragionamento che scegli per provider viene salvato solo nel local storage del browser corrente. Non viaggia verso un browser diverso, un computer diverso o una finestra privata, dove riparte da Default. Se le tue risposte sembrano improvvisamente più superficiali dopo aver cambiato macchina, riseleziona lì il livello di ragionamento. La tua chiave, il tuo modello e le impostazioni avanzate non ne risentono, solo il livello di ragionamento è locale al browser.

Cosa significa ciascun messaggio di Test connection

Test connection mappa un errore grezzo del provider su un messaggio breve e chiaro, ed è limitato a 10 test al minuto per account.

Messaggio	Cosa significa
Connection successful, key is valid.	La chiave ha funzionato e il provider ha risposto.
Key saved (this provider has no live test)	fal.ai e BytePlus non hanno un endpoint economico da interpellare, quindi si conferma solo che la chiave è stata salvata.
No test for a custom provider, try it in chat	Un endpoint personalizzato non ha un'azione di test; invia un messaggio in chat per verificarlo.
Key is invalid, you may have copied it incompletely	Il provider ha rifiutato la chiave (un errore di tipo 401 o 403). Ricopiala per intero.
Provider is busy (429), try again shortly	Il provider ha restituito un limite di frequenza (429). Attendi un momento e riprova.
Could not reach the provider (network/CORS)	Un errore di rete o CORS ha impedito alla richiesta di arrivare.
Save your key first.	Non c'è ancora una chiave salvata da testare.
Too many tests, try again in a minute.	Hai superato i 10 test in un minuto; fermati un attimo e riprova.

Eliminare una chiave non rimuove ciò che hai creato

Rimuovere la chiave di un provider interrompe solo le nuove richieste verso di esso. La tua galleria di immagini e clip generate, e le conversazioni che hai già avuto, restano al loro posto. Vedi Cambiare o rimuovere una chiave qui sopra per i passaggi esatti.

Correlati

• Usa la tua chiave AI
• Matrice provider e modelli
• Usare la chat AI
• Assistente chat AI per la versione della stessa configurazione dentro l'editor