Che cos'è una chiave API
Una chiave API è una lunga password che collega Rectoly a un'azienda di IA. Ti registri presso l'azienda a tuo nome, e l'azienda ti rilascia la chiave.
- Rectoly non ha alcun contratto con le aziende di IA. Con la tua chiave, Rectoly chiede all'azienda di fare il lavoro a tuo nome, e l'azienda addebita i costi a te.
- All'azienda arrivano i paragrafi che traduci e il testo delle note che organizzi. I file dei tuoi articoli non vengono inviati. Vedi Che cosa viene inviato.
- Non serve una chiave per usare l'IA su Questo dispositivo. Una chiave serve a un dispositivo che non può eseguire il modello, o a quando preferisci usare il modello di un'azienda. Vedi Scegli dove viene eseguita l'IA.
- Un abbonamento all'app ChatGPT o Gemini è separato dall'API. Non ti dà alcuna chiave API né credito API.
- In alcune regioni e store le impostazioni non hanno IA. Lì una chiave non si può usare.
In Rectoly, Ottieni una chiave apre la pagina delle chiavi dell'Azienda di IA che hai scelto. I passaggi per ogni azienda sono qui sotto: OpenAI, Google Gemini, DeepSeek.
Quanto costa
Le schermate dell'app danno una stima di quanto testo viene inviato, mai un prezzo. Questa pagina è l'unico posto in cui Rectoly indica somme di denaro, e sono approssimative.
- Le aziende contano il testo in token, piccoli pezzi di parole. Tradurre un intero articolo invia e riceve circa 20.000–40.000 token.
- Con i modelli qui sotto, tradurre un intero articolo costa al massimo pochi centesimi di dollaro. Organizza con l'IA e le schede degli articoli ne usano molto meno.
| Azienda di IA | Modello | Inviato, per 1M di token | Restituito, per 1M di token | Un articolo tradotto |
|---|---|---|---|---|
| OpenAI | gpt-4.1-mini | 0,40 $ | 1,60 $ | circa 0,02–0,04 $ |
| Google Gemini | gemini-2.5-flash-lite | 0,10 $ | 0,40 $ | circa 0,01 $ o meno |
| DeepSeek | deepseek-flash | 0,30 $ (2 yuan) | 1,20 $ (8 yuan) | circa 0,01–0,03 $ (0,1–0,2 yuan) |
- Questi sono i prezzi indicati nella pagina dei prezzi di ciascuna azienda il 16 ottobre 2026. I prezzi cambiano, e fa fede la pagina dell'azienda: OpenAI, Google Gemini, DeepSeek.
- I prezzi di DeepSeek valgono per le sue ore di punta (l'orario di lavoro nei giorni feriali a Pechino). Negli altri momenti sono la metà.
Pagare in anticipo. OpenAI e DeepSeek funzionano a credito prepagato: metti prima i soldi, e ogni richiesta viene pagata da quel credito. Quando finisce, l'azienda smette di accettare richieste, quindi spendi circa quello che hai versato e non di più. La ricarica minima di OpenAI è di 5 $, e il credito scade dopo un anno.
Gratis. Google Gemini ha un livello gratuito: una chiave di Google AI Studio funziona senza pagamento, con un limite al numero di richieste al minuto e al giorno. Nel livello gratuito, Google può usare ciò che invii per migliorare i suoi prodotti. Per un manoscritto in revisione o qualsiasi cosa riservata, attiva prima la fatturazione.
Tenere sotto controllo la spesa.
- OpenAI: quando aggiungi credito, disattiva la ricarica automatica (auto recharge). Settings › Limits su platform.openai.com può mandarti un'email quando la spesa raggiunge una cifra che imposti.
- Google Gemini: in Google AI Studio, Spend › Monthly spend cap imposta un tetto mensile per un progetto con la fatturazione.
- DeepSeek: non viene addebitato nulla in automatico. Il saldo che ricarichi è il limite.
OpenAI
Questi passaggi mostrano le schermate al 16 ottobre 2026. L'azienda potrebbe cambiarle.
1. Crea un account
Apri platform.openai.com e registrati con un indirizzo email o con un account Google, Microsoft o Apple. Potrebbe esserti chiesto di confermare un numero di telefono. Qui funziona anche un account ChatGPT.
2. Aggiungi credito
In Settings › Billing, premi Add payment details e aggiungi credito (5 $ o più). Disattiva auto recharge a meno che tu non voglia la ricarica automatica. Senza credito, la chiave non funziona.
3. Apri la pagina delle chiavi API
Apri platform.openai.com/api-keys e premi Create new secret key. In Rectoly, Ottieni una chiave apre questa pagina.
4. Dai un nome alla chiave e creala
Scrivi un nome che riconoscerai, per esempio "Rectoly", e premi Create secret key. Lascia le altre scelte come sono.
5. Copia la chiave
Premi Copy. La chiave inizia con sk-. Una volta chiusa questa finestra, la chiave non viene mai più mostrata. Se la perdi, eliminala e creane una nuova.
6. Incollala in Rectoly
In Rectoly, apri Impostazioni › IA e scegli La tua chiave API sotto Dove viene eseguita l’IA (la prima volta, leggi l'avviso e accetta). Scegli OpenAI come Azienda di IA e premi Incolla e verifica. Quando compare In uso:, la traduzione, Organizza con l’IA e le schede degli articoli funzionano con OpenAI. Per saperne di più: Configura la tua chiave API.
Un video di questi passaggi è in preparazione.
Google Gemini
Questi passaggi mostrano le schermate al 16 ottobre 2026. L'azienda potrebbe cambiarle.
1. Apri Google AI Studio
Apri aistudio.google.com/apikey e accedi con il tuo account Google. La prima volta, accetta le condizioni. Un account della scuola o del lavoro potrebbe non essere autorizzato a usarlo; in tal caso usa un account personale. In Rectoly, Ottieni una chiave apre questa pagina.
2. Crea una chiave
Premi Create API key.
3. Scegli un progetto
Scegli il progetto a cui appartiene la chiave e crea la chiave. Un nuovo account ha già un progetto; scegli quello.
4. Copia la chiave
Copia la chiave che compare. Inizia con AQ., non con AIza come le chiavi Gemini di una volta.
5. Incollala in Rectoly
In Rectoly, apri Impostazioni › IA e scegli La tua chiave API sotto Dove viene eseguita l’IA (la prima volta, leggi l'avviso e accetta). Scegli Google Gemini come Azienda di IA e premi Incolla e verifica. Quando compare In uso:, la traduzione, Organizza con l’IA e le schede degli articoli funzionano con Gemini. Per saperne di più: Configura la tua chiave API.
- La chiave parte dal livello gratuito. Per superarne i limiti, premi Set up billing in Google AI Studio. Vedi Quanto costa.
Un video di questi passaggi è in preparazione.
DeepSeek
Questi passaggi mostrano le schermate al 16 ottobre 2026. L'azienda potrebbe cambiarle.
1. Registrati
Apri platform.deepseek.com e registrati con un numero di telefono o un indirizzo email.
2. Ricarica prima
Apri Top up e paga in anticipo. DeepSeek non accetta richieste senza un saldo. I metodi di pagamento dipendono dalla tua regione.
3. Apri le chiavi API
Apri API keys e premi Create new API key. In Rectoly, Ottieni una chiave apre questa pagina.
4. Dai un nome alla chiave e copiala
Scrivi un nome come "Rectoly", crea la chiave e copiala. La chiave inizia con sk- e viene mostrata una sola volta.
5. Incollala in Rectoly
In Rectoly, apri Impostazioni › IA e scegli La tua chiave API sotto Dove viene eseguita l’IA (la prima volta, leggi l'avviso e accetta). Scegli DeepSeek come Azienda di IA e premi Incolla e verifica. Quando compare In uso:, la traduzione, Organizza con l’IA e le schede degli articoli funzionano con DeepSeek. Per saperne di più: Configura la tua chiave API.
Un video di questi passaggi è in preparazione.
Tenere al sicuro la chiave
Chiunque abbia la tua chiave può usare l'IA dell'azienda a tue spese.
- Non mostrarla a nessuno. Tienila fuori da screenshot, chat e documenti condivisi.
- Non inviarla a nessuno, nemmeno al supporto di Rectoly. Non te la chiediamo mai.
- Se potrebbe essere trapelata, eliminala nella pagina delle chiavi dell'azienda e creane una nuova, poi incolla la nuova chiave in Rectoly.
- Rectoly conserva la chiave solo su questo dispositivo: nel Portachiavi su iPad, iPhone e Mac, cifrata con una chiave custodita nell'hardware sicuro del dispositivo su Android, cifrata per il tuo utente Windows su Windows, e cifrata in un file che solo il tuo utente può leggere su Linux.
- La chiave non viene sincronizzata con gli altri tuoi dispositivi. Incollala su ciascun dispositivo, oppure dai a ogni dispositivo una chiave propria, così puoi eliminarne una senza toccare le altre.
Quando qualcosa va storto
| Che cosa dice Rectoly | Che cosa significa | Che cosa fare |
|---|---|---|
| La chiave API non è stata accettata. | La chiave è sbagliata, tagliata o eliminata | Copia di nuovo la chiave dalla pagina dell'azienda e premi Incolla e verifica. Controlla che l'Azienda di IA sia quella che ha rilasciato la chiave |
La chiave API non è stata accettata. per una chiave Gemini che inizia con AQ. | Da fine maggio 2026 Google sta passando a un nuovo tipo di chiave (AQ.), e AI Studio non crea più il tipo vecchio (AIza). Rectoly accetta il tipo nuovo, quindi il rifiuto viene da Google, a metà del suo passaggio | Aspetta e riprova più tardi. Alcuni utenti segnalano sul Google AI Developers Forum che funziona una chiave creata per la Gemini API nella console di Google Cloud |
| Questa non ha la forma di una chiave (azienda). | Hai incollato la chiave di un'altra azienda, o qualcosa che non è una chiave | Scegli l'Azienda di IA che ha rilasciato la chiave, oppure copia di nuovo la chiave |
| …limite di utilizzo… | Troppe richieste in poco tempo, oppure il credito prepagato è finito (OpenAI dice questo quando il credito finisce) | Aspetta un po'. Se continua, aggiungi credito nella pagina dell'azienda. Il livello gratuito di Gemini azzera il limite giornaliero il giorno dopo |
| …ha respinto la richiesta: seguito dal messaggio dell'azienda | L'azienda ha dato un motivo suo. Insufficient Balance significa che il credito prepagato è esaurito; un messaggio sul modello significa che quel modello non è disponibile | Ricarica, oppure scegli un altro modello sotto Avanzate |
| …non risponde… | Il servizio dell'azienda è sovraccarico o non funziona | Aspetta e riprova. La pagina di stato di ogni azienda dice se ha un problema: OpenAI, Google Gemini, DeepSeek |
| Impossibile connettersi. | Questo dispositivo non è online, oppure la rete blocca l'azienda | Controlla la connessione. La rete di una scuola o di un ufficio può bloccare l'azienda |