Guida passo passo

Collegare l’intelligenza artificiale a Torchio

Ci vogliono circa cinque minuti e non serve sapere niente di informatica. Guarda il filmato, poi segui i passaggi qui sotto: sono scritti per chi non l’ha mai fatto.

La tua chiave

apre il tuo conto presso il servizio di IA

platform.claude.com
ConsoleBillingAPI keys
Billing

Credito disponibile: 0,00 $

Buy credits
Quanto vuoi caricare?
Conferma
API keys

Nessuna chiave per ora.

Create key
Nome della chiave
Crea
La tua nuova chiave

Copiala adesso: per sicurezza non verrà più mostrata per intero.

sk-ant-api03-7fQk…Lw9A Copia Copiata
Torchio
Configura l’IA
Ciao!Che storia scriviamo oggi?
Intelligenza artificiale
ClaudeChatGPTGeminiOpenRouter
La tua chiave
sk-ant-…
Incolla
SalvaSalva e prova

Fatto!Ora puoi scrivere il tuo romanzo

0:00

Il filmato mostra Claude, il servizio per cui Torchio è stato pensato. Con ChatGPT, Gemini e OpenRouter i passaggi sono quasi identici: li trovi qui sotto.

1

Cos’è una chiave API, in parole semplici

Torchio non contiene un’intelligenza artificiale sua: usa quella di grandi servizi come Claude, ChatGPT o Gemini. Per farlo ha bisogno del permesso di usare il tuo conto presso uno di questi servizi.

La chiave API è quel permesso: una lunga sequenza di lettere e numeri che crei tu, sul sito del servizio, e incolli in Torchio. Funziona come la tessera di una ricarica prepagata: ogni volta che Torchio scrive, il servizio scala dal tuo credito il costo di quel lavoro.

Perché funziona così?

Perché così paghi solo quello che usi, direttamente al servizio, senza abbonamenti a Torchio. E i tuoi romanzi non passano da nessun server di Torchio: vanno dal tuo telefono al servizio di IA, e tornano indietro.

2

Quale servizio scegliere

Ne basta uno. Se non sai quale, scegli Claude: Torchio è stato costruito pensando alla sua qualità di scrittura.

Consigliato

Claude

Di Anthropic. Ottimo per la narrativa in italiano. Si paga con credito prepagato.

Guida qui sotto

ChatGPT

Di OpenAI. Credito prepagato, a partire da 5 dollari. L’abbonamento ChatGPT Plus non vale per le chiavi.

Guida
Ha un piano gratuito

Gemini

Di Google. Si può iniziare gratis e senza carta, con limiti al numero di richieste.

Guida

OpenRouter

Una sola chiave per tanti modelli di aziende diverse. Per chi vuole provare un po’ di tutto.

Guida
3

Creare la chiave di Claude

Ti serve una carta di pagamento, anche prepagata o di debito. Il sito del servizio è in inglese: qui sotto trovi i nomi esatti dei pulsanti.

  1. Apri la Claude Console. Vai su platform.claude.com, oppure in Torchio scegli Claude e tocca «Crea la chiave». Registrati con la tua email o con Google. È un account diverso dall’abbonamento Claude Pro: le due cose si pagano separatamente.
  2. Carica un po’ di credito. Apri Settings, poi Billing, e premi Buy credits. Scegli l’importo, inserisci indirizzo e carta, conferma. Parti con poco: il credito acquistato scade dopo un anno e non è rimborsabile.
  3. Crea la chiave. Apri API keys e premi Create key. Come nome scrivi qualcosa che ti ricordi, per esempio «Torchio». Il resto puoi lasciarlo com’è.
  4. Copiala subito. La chiave inizia con sk-ant- e viene mostrata per intero una sola volta. Premi Copy e passa a Torchio. Se la perdi, nessun problema: ne crei un’altra e cancelli la vecchia.
Con ChatGPT (OpenAI)
  1. Vai su platform.openai.com e accedi. È diverso da chatgpt.com: l’abbonamento Plus non dà credito per le chiavi.
  2. Apri Settings, poi Billing: aggiungi un metodo di pagamento e compra credito. Il minimo è 5 dollari.
  3. Apri API keys, premi Create new secret key, dai il nome «Torchio» e conferma.
  4. Copia la chiave, che inizia con sk-: anche qui viene mostrata una volta sola.
  5. In Torchio scegli ChatGPT (OpenAI) e incollala.
Con Gemini (Google)
  1. Vai su aistudio.google.com e accedi con il tuo account Google.
  2. Premi Get API key, poi Create API key. Se ti chiede un progetto, scegli di crearne uno nuovo.
  3. Copia la chiave, che inizia con AIza.
  4. In Torchio scegli Gemini (Google) e incollala.

Il piano gratuito ha limiti di richieste al minuto e al giorno: con capitoli lunghi potresti doverti fermare fino al giorno dopo. Inoltre, secondo le condizioni di Google, sul piano gratuito i testi inviati possono essere usati per migliorare i suoi servizi: se il romanzo è riservato, valuta di attivare la fatturazione sul progetto.

Con OpenRouter
  1. Vai su openrouter.ai e crea un account.
  2. Apri Credits e aggiungi un po’ di credito.
  3. Apri Keys, premi Create key, dai il nome «Torchio».
  4. Copia la chiave, che inizia con sk-or-, e in Torchio scegli OpenRouter.
4

Inserire la chiave in Torchio

  1. Apri Torchio e, nella schermata iniziale, tocca «Configura l’IA»: è la pillola con il pallino arancione in alto.
  2. Scegli il servizio per cui hai creato la chiave: Claude, ChatGPT, Gemini o OpenRouter.
  3. Incolla la chiave: tieni premuto nel campo «La tua chiave» e scegli Incolla. Con Mostra puoi controllare che sia completa.
  4. Premi «Salva e prova». Se compare «Funziona: puoi iniziare a scrivere», hai finito: il pallino diventa verde.

Con ChatGPT, Gemini e OpenRouter, Torchio carica anche l’elenco dei modelli e sceglie da solo quelli adatti a scrivere, ad analizzare e alla memoria della storia. Puoi cambiarli quando vuoi nella stessa schermata.

5

Usare la chiave su telefono, tablet e computer

Puoi incollare la chiave a mano su ogni dispositivo, oppure farla arrivare da sola.

  1. In Torchio accedi con il tuo account Google.
  2. Nella schermata dell’intelligenza artificiale, in fondo, trovi «Chiavi su tutti i tuoi dispositivi».
  3. Scegli una frase segreta di almeno 8 caratteri, ripetila e premi «Attiva la sincronizzazione».
  4. Sugli altri dispositivi accedi con lo stesso account, inserisci la frase e premi «Sblocca».

La chiave viene cifrata sul tuo dispositivo con la frase segreta, che conosci solo tu: nemmeno Torchio può leggerla. Se la dimentichi, tocca «Ho dimenticato la frase» e scegline una nuova.

6

Quanto costa, e come non spendere troppo

I servizi contano il testo in token, piccoli pezzi di parola: paghi quelli che Torchio invia e quelli che riceve. Scrivere un capitolo costa molto meno che leggere un libro intero, e i modelli più economici bastano per le bozze.

  • Prima dei lavori lunghi, come scrivere tutti i capitoli, Torchio ti mostra una stima del consumo e aspetta la tua conferma.
  • Nella schermata dell’IA vedi quanti token hai usato da quel dispositivo.
  • Parti con una ricarica piccola e guarda quanto consumi in una settimana.
  • Ricarica automatica: se il servizio la propone, lasciala spenta o imposta un tetto mensile.
7

Tenere al sicuro la chiave

  • Trattala come una password. Chi la possiede può usare il tuo credito. Non mandarla a nessuno e non pubblicarne foto o screenshot.
  • Torchio la tiene sul tuo dispositivo e la invia solo al servizio che hai scelto, mai altrove.
  • Se pensi che qualcuno l’abbia vista, cancellala sul sito del servizio e creane una nuova: quella vecchia smette subito di funzionare.
  • Su un dispositivo condiviso, quando hai finito usa «Cancella la chiave» nella schermata dell’IA.
8

Se qualcosa non va

«La chiave non è valida o è stata revocata»

Di solito la chiave è stata copiata a metà o con uno spazio in più. Copiala di nuovo dal sito del servizio; se non è più visibile, creane una nuova.

«Le chiavi di Claude iniziano con sk-ant-»

Hai incollato qualcos’altro, oppure una chiave di un altro servizio. Controlla di aver scelto il servizio giusto in alto.

«Il tuo account presso il servizio di IA ha finito il credito o la quota»

Ricarica il credito sul sito del servizio. Con il piano gratuito di Gemini hai raggiunto il limite: aspetta qualche ora o attiva la fatturazione.

«Il modello scelto non è disponibile con la tua chiave»

Apri la schermata dell’IA e scegli un altro modello dall’elenco.

«Troppe richieste ravvicinate»

Il servizio chiede una pausa: aspetta un minuto e riprova.

Ho perso la chiave

Nessun problema: creane una nuova sul sito del servizio, incollala in Torchio e cancella la vecchia.

Ancora bloccato? Scrivimi a : rispondo io.

Pronto a scrivere?

Apri Torchio, tocca «Configura l’IA» e incolla la tua chiave.

Apri Torchio