Abbonamenti IA e chiavi API: guida passo passo

Prima, i termini

Non serve sempre una chiave API per scrivere mazzi e studiare. Serve per generare con il tuo account IA.

1. Abbonamento, API e pass sono distinti

Un’API consente a un programma di richiedere un lavoro all’IA. La chiave è una credenziale segreta che autorizza l’uso del tuo account. Non è il codice e-mail, la chiave di recupero Quiz Notebook o la password della chat.

Chat e API hanno fatturazioni separate anche usando la stessa e-mail. Non devi prima acquistare un abbonamento alla chat per usare l’API: verifica la fatturazione API.

2. Scegliere il metodo

Puoi lavorare manualmente nella chat IA che già usi, controllare l’output e importarlo in un formato compatibile. È un percorso separato dal collegamento API.

Con BYOK gestisci chiave, modello e spesa. Il collegamento descritto supporta OpenAI e Anthropic direttamente; non accetta credenziali Gemini, NotebookLM, Azure o Bedrock.

Per un mazzo su commissione non inviare la tua chiave. Il servizio prevede valutazione preliminare, accordo sull’ambito, revisione e consegna. Consulta la pagina del servizio per l’apertura degli ordini a pagamento.

3. Preparazione

Prepara account e fatturazione API, ID di un modello accessibile e un breve esempio che hai diritto di trasmettere. Per account scolastici o aziendali verifica l’autorizzazione ai servizi esterni.

Servono accesso tramite e-mail, pass valido e dispositivo registrato e attivo nelle impostazioni dell’account. Una chiave non abilita una funzione ancora chiusa.

Non inserire chiavi in questa guida, nei moduli o nelle e-mail. Usa solo il campo mascherato dell’applicazione ufficiale.

4. Creare una chiave OpenAI

1. Accedi a OpenAI API Platform, separata dalle impostazioni di abbonamento ChatGPT.
2. Crea o seleziona un progetto dedicato a Quiz Notebook nella tua organizzazione, per separare consumi e revoca.
3. Verifica API Billing, metodo di pagamento e crediti. Disattiva Auto-reload e salva se non vuoi acquisti automatici.
4. In API Keys del progetto crea una chiave segreta, assegnale un nome riconoscibile e conservala in un gestore di password sicuro.
5. Concedi solo i permessi necessari: occorre creare richieste Responses API, quindi Read Only non basta. Non usare una chiave amministratore.
6. Cerca l’ID API esatto del modello nella documentazione e verifica l’accesso del progetto. Il nome del piano o quello mostrato in chat non è l’ID.

Se perdi il segreto, crea una nuova chiave e revoca quella precedente. Fatturazione e permessi di progetto e modello devono essere validi.

5. Creare una chiave Claude / Anthropic

1. Accedi a Claude Console, distinta da Claude Pro o Max.
2. Scegli organizzazione e workspace, configura API Billing e verifica ricariche e controlli di spesa disponibili.
3. Crea una chiave di inferenza in API Keys. Usa una chiave per un singolo workspace, non una chiave amministratore o credenziali di un altro cloud.
4. Verifica nome, permessi e scadenza; conserva il segreto e ricorda quale workspace monitorare.
5. Trova un ID di modello disponibile nella documentazione e seleziona Anthropic in Quiz Notebook.

Un abbonamento Claude a pagamento non sostituisce crediti e fatturazione API di Console.

6. Collegare Quiz Notebook

1. Accedi all’app ufficiale e controlla pass e dispositivo attivo nelle impostazioni.
2. Scegli un mazzo; inizia con una o due brevi domande e risposte scritte da te.
3. Apri ‘내 API로 AI 후보 만들기’ (Crea candidati con la mia API) sotto il mazzo. Il campo non è nelle impostazioni dell’account.
4. Seleziona OpenAI o Anthropic, inserisci l’ID esatto del modello e la chiave in ‘본인 API 키’, senza spazi o ritorni a capo aggiuntivi.
5. Leggi e accetta l’avviso su invio e costi separati. Viene inviato il testo delle domande e risposte; immagini e allegati non vengono letti automaticamente.
6. Premi una volta ‘별도 후보 덱 만들기’ (Crea un mazzo candidato separato) e attendi. Inserire la chiave non avvia una chiamata.
7. Controlla il mazzo separato rispetto alle fonti: correttezza, spiegazioni e diritti. Non viene unito automaticamente all’originale né revisionato dal servizio su commissione.
8. Controlla Usage e Billing del fornitore prima di aumentare il materiale.

7. Percorso di chiave e materiali

Il percorso è browser → server Quiz Notebook → fornitore IA scelto → browser. Il server gestisce temporaneamente la chiave in memoria; non è un collegamento esclusivamente diretto al fornitore.

L’implementazione attuale non conserva la chiave nel database dell’account o nell’archiviazione persistente del browser e non registra intenzionalmente il corpo delle richieste. Ricaricare o uscire cancella la chiave sullo schermo. Non è una garanzia di conservazione zero presso il fornitore IA.

La sincronizzazione privata cifrata è separata dall’invio di testo leggibile all’IA. Rimuovi nomi, contatti e dati degli studenti non necessari e verifica i diritti di uso e trasmissione.

8. Controllare i costi

Il costo dipende da modello, token in ingresso e uscita e numero di chiamate. Token e caratteri non coincidono. Fonti lunghe, risposte lunghe e ripetizioni possono costare di più.

Stima token in ingresso × tariffa di ingresso + token in uscita × tariffa di uscita usando le unità del listino ufficiale. Considera cache, ragionamento, imposte e cambio. Il pass web è separato.

Gli avvisi OpenAI non fermano le richieste. In Limits verifica e salva ‘Enforce a hard limit’ se vuoi un limite applicato. Un ritardo può consentire un lieve superamento. Il limite di ricarica automatica riguarda gli acquisti di crediti, non la spesa API.

Anche in Claude Console controlla consumi di organizzazione/workspace e fatturazione. Inizia con poco; verifica separatamente avvisi, limiti e ricariche.

9. Scollegare, sostituire o annullare

1. ‘입력한 API 키 지우기’ (Cancella la chiave inserita) rimuove chiave e consenso dallo schermo. Non annulla richieste in corso.
2. Per impedire altri utilizzi futuri, revoca o elimina la chiave in API Keys del fornitore. Svuotare il campo non la revoca.
3. Ricollega una nuova chiave. Se sospetti una divulgazione, revoca prima la precedente e controlla Usage e Billing.
4. Gestisci separatamente abbonamento chat, ricariche API e pass Quiz Notebook. Annullarne uno non annulla gli altri.

Per assistenza comunica ora, fornitore, ID modello e una schermata senza segreti. Non inviare mai la chiave completa.

10. Risolvere i problemi

Pulsante disabilitato: controlla disponibilità, accesso, pass, consenso e richieste in corso. Per errori del dispositivo controlla registrazione e attivazione.

Errore chiave/modello: verifica fornitore, spazi, scadenza, revoca, permessi e ID esatto. Pagare la chat non finanzia l’API.

Quota o congestione: verifica saldo, limiti di velocità e spesa. I nuovi crediti possono apparire in ritardo. Non acquistare ripetutamente prima della diagnosi.

Timeout o formato non valido: non c’è un tentativo automatico. Il fornitore potrebbe aver svolto lavoro fatturabile. Controlla Usage prima di riprovare con meno testo.

Contenuto errato: collegamento riuscito non significa correttezza verificata. Correggi o scarta i candidati privi di fondamento.

11. Condivisione, diritti e organizzazioni

Non condividere chiavi con amici o studenti: il costo può ricadere sullo stesso account. Le soluzioni istituzionali richiedono accordi su titolarità, permessi e costi. Non allegare chiavi o dati reali degli studenti a una richiesta.

Consigliamo lo studio personale. Verifica i diritti prima di inviare libri o appunti altrui a un’IA esterna, pubblicare o vendere risultati. La riservatezza non elimina automaticamente i problemi di copyright.

La chiave API autorizza le chiamate IA; il codice e-mail permette l’accesso; la chiave di recupero apre i mazzi cifrati. Non sono intercambiabili.

12. Domande frequenti

Inserire la chiave costa? La sola digitazione non invia richieste. La generazione può essere fatturata quando viene elaborata.

Risultato uguale alla chat? Modelli, istruzioni, impostazioni e strumenti possono variare. Ricerca e allegati della chat non sono automaticamente inclusi.

Devo reinserirla? Sì dopo ricaricamento o uscita, perché non è salvata permanentemente. Restare connessi all’account è distinto.

Stesso menu nelle app installate? Questa guida riguarda il Web. Consulta i manuali di tablet e desktop per procedure e disponibilità della versione.