Alternativa a OpenRouter per Janitor AI: Guida alla configurazione

Cosa devi inserire

Se vuoi un'alternativa a OpenRouter per Janitor AI o un'app di chat per personaggi simile, la configurazione è la stessa per qualsiasi provider compatibile con OpenAI. Trova il punto nel tuo client dove aggiungere un'API personalizzata o proxy. Le app diverse la etichettano in modo diverso: "proxy", "endpoint OpenAI personalizzato", "URL API". I campi sottostanti sono sempre gli stessi tre.

Campo	Valore
URL API / URL base	https://api.openrouterapi.cc/v1
Chiave API	La chiave del tuo account, inviata come Authorization: Bearer
Nome del modello	uncensored

Alcuni client vogliono l'endpoint completo invece della base. Se il salvataggio dell'URL base restituisce un errore o un 404, prova https://api.openrouterapi.cc/v1/chat/completions. I due metodi supportati sono POST /v1/chat/completions e GET /v1/models, quindi un client che elenca i modelli chiamerà il secondo e vedrà uncensored.

Se non hai ancora una chiave, registrati con Google o con email e password e segui le istruzioni per la chiave API. I nuovi account possono richiedere un credito di prova di $0,50 con un clic, sufficiente per una prima sessione di test.

Testa la connessione prima di dare la colpa all'app

Le interfacce di roleplay nascondono il testo grezzo degli errori. Esegui prima una richiesta da un terminale, così sai che la chiave e il modello funzionano. Sostituisci il segnaposto con la tua chiave.

Copycurl https://api.openrouterapi.cc/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are Mara, a dry-witted ship engineer."},
      {"role": "user", "content": "The reactor is humming wrong again."}
    ],
    "temperature": 0.9,
    "max_tokens": 200
  }'

Se questo restituisce una risposta, l'endpoint e la chiave sono a posto e qualsiasi problema risiede nelle impostazioni dell'app. Se fallisce, il corpo dell'errore ti dice il motivo. Conserva l'ID della richiesta dall'intestazione di risposta X-Request-Id; ti aiuterà quando scriverai a support.

Un system prompt iniziale

Una scheda personaggio in un'interfaccia diventa solitamente il messaggio di sistema. Qualunque cosa faccia la tua app, il modello riceverà qualcosa di simile al testo sottostante. Il modello è ottimizzato per rispondere senza rifiuti di contenuti per l'uso adulto legale, quindi il prompt non deve litigare con lui. Deve essere chiaro riguardo alla voce, ai limiti e al formato.

Sei Mara Voss, ingegnere capo sul cargo Calloway.

Voce: asciutta, pratica, pronta a scherzare sotto stress.

Scrivi in terza persona al passato, in 2-4 brevi paragrafi.

Non parlare mai né agire per il personaggio dell'utente.

Mantieni la continuità: tieni traccia di ferite, riparazioni e di chi sa cosa.

Rimani nella storia. Tutti i personaggi sono adulti.

Due abitudini migliorano le sessioni lunghe. Primo, mantieni il prompt di sistema breve, perché viene inviato a ogni turno. Secondo, inserisci le regole rigide alla fine del prompt, non nel mezzo, così rimangono in primo piano quando la cronologia della chat cresce. Se la tua app ti permette di aggiungere una "nota dell'autore" o un promemoria che viene inserito vicino al messaggio più recente, usalo per le regole di stile.

Una regola è fissa su questo servizio e nel tuo prompt: nessun contenuto sessuale che coinvolga minorenni. Scriverlo nella scheda personaggio mantiene pulite anche le tue schede.

Impostazioni che di solito funzionano

Questi sono punti di partenza, non garanzie. Modifica un parametro alla volta e confronta alcune risposte.

• Temperature 0,8-1,0 per un dialogo vivace. Scendi a circa 0,6 se il personaggio si allontana o si contraddice.
• top_p 0,9-0,95 se il tuo client lo espone. Viene passato invariato.
• Penalità di frequenza e presenza da 0,2 a 0,5 quando le risposte iniziano a ripetere frasi. Valori elevati rendono la prosa strana, quindi mantienili bassi.
• max_tokens è opzionale. Imposta 300-600 se vuoi risposte di lunghezza paragrafo e non saggi.
• Streaming attivo. La risposta appare mentre viene scritta e il blocco finale contiene i dati di utilizzo così il tuo client può mostrare i conteggi dei token.
• seed viene passato invariato, utile quando vuoi confrontare due versioni del prompt sullo stesso turno.

Lo streaming ha un effetto collaterale da conoscere: una richiesta in streaming mantiene il suo slot di concorrenza fino alla fine dello stream. Una chiave completa permette 8 richieste alla volta e 300 al minuto. Una chiave di prova permette 2 richieste alla volta e 60 al minuto.

Contesto, memoria e quanto costano le chat lunghe

La finestra di contesto è di 100.000 token, prompt più completamento. È una storia enorme: decine di migliaia di parole di cronologia possono essere inserite. Il costo cresce con essa, perché l'intera cronologia viene inviata ogni volta. Ecco un esempio pratico per una sessione lunga.

Supponi che la cronologia sia cresciuta a 30.000 token e la risposta sia di 300 token. Input: 30.000 x $0,15 / 1M = $0,0045. Output: 300 x $0,50 / 1M = $0,00015. Una risposta costa $0,00465. Cento risposte di quella dimensione equivalgono a $0,465, quindi circa 47 centesimi.

Una cronologia più breve è più economica e spesso migliore. I modelli prestano meno attenzione al mezzo di prompt molto lunghi, quindi un riassunto pulito degli eventi passati più le ultime dodici messaggi possono essere letti in modo più coerente rispetto a 30.000 token grezzi. Molte interfacce hanno una funzione di riassunto o "memoria". Usala quando la chat supera qualche migliaio di token.

I prezzi sono $0,15 per 1M di input e $0,50 per 1M di output. Le richieste fallite o rifiutate non vengono addebitate e il credito non scade mai. Vedi la pagina dei prezzi per importi di ricarica, bonus e metodi di pagamento, inclusi carta e cripto.

Mantenere la coerenza di un personaggio nel tempo

I personaggi a lungo termine si degradano. La soluzione è principalmente la gestione dei dati e costa molto pochi token se fatta bene.

Mantieni un blocco fisso di fatti che non cambia mai: nome, personalità, abitudini di linguaggio, relazioni. Mantieni un secondo blocco che aggiorni manualmente ogni tanto: la situazione attuale, le trame aperte, le promesse fatte. Incolla entrambi nel system prompt o nel campo memoria del tuo client e mantieni ciascuno sotto circa 500 token. Insieme sono al massimo 1.000 token, che costano $0,00015 per risposta al tasso di input.

Poi lascia che la chat live porti solo lo scambio recente. Quando una scena finisce, scrivi due o tre frasi di riassunto nel secondo blocco e cancella i vecchi messaggi. I tuoi personaggi rimangono nitidi, le risposte sono più veloci da leggere e il costo per risposta rimane vicino a un decimo di centesimo invece di salire con ogni sessione.

Se gestisci diversi personaggi in una chat, specifica chi parla e quando. Una riga come "Scrivi solo le battute di Mara a meno che l'utente non chieda un altro personaggio" impedisce al modello di narrare tutti contemporaneamente, il che mantiene anche le risposte brevi ed economiche.

Risoluzione problemi 429 e risposte strane

Le app di roleplay sono bravi a innescare i limiti di velocità per errore: due schede del browser, un pulsante "rigenera" premuto due volte, una chat di gruppo in cui diversi personaggi rispondono contemporaneamente. L'API risponde con HTTP 429 e uno di questi motivi.

1. Codice di errore concurrency. Hai più richieste in corso di quanti ne consenta la tua chiave. Chiudi le schede extra, attendi che lo stream termini o disattiva le risposte parallele dei personaggi. Ricorda che uno stream occupa la sua slot fino alla fine.
2. Codice di errore rate_limited. Hai inviato troppe richieste in un minuto. Rallenta; una persona che digita raramente raggiunge i 300 al minuto, ma un ciclo automatico di swipe può raggiungere 60 con una chiave di prova.
3. 429 con un'intestazione Retry-After: 5. Il servizio è temporaneamente sovraccarico. Attendi cinque secondi e invia di nuovo.

Se le risposte sono troncate, controlla l'impostazione max_tokens nel client. Se il personaggio parla per te, rafforza la regola nel prompt di sistema e abbassa la temperatura. Se l'app segnala che il modello non è stato trovato, assicurati che il campo del modello sia esattamente uncensored, in minuscolo.

Dove si inserisce e dove non si inserisce

Funziona come soluzione pronta all'uso quando il tuo client ti permette di scegliere il tuo endpoint e vuoi un singolo modello con un prezzo per token uniforme. Non sostituisce un router se ti piace cambiare tra molti modelli a metà chat. Ottieni un modello, da un provider indipendente, non l'API ufficiale di alcun fornitore di modelli.

Il modello è solo testo. Non genera arte dei personaggi, voce o video e gli embedding non sono disponibili. Tutto nel tuo client che dipende da queste funzionalità richiede un altro servizio. I prompt non vengono utilizzati per l'addestramento e la guida rapida completa è nella documentazione.

Altre guide

• Alternative a OpenRouter più economiche: costi dei token calcolati
• Alternativa a OpenRouter per modelli AI: Uno contro molti
• API Perplexity: Come usare LLM senza censura