Come usare OpenRouter su Janitor AI: configurazione del proxy

Come funziona la connessione

Janitor AI è un sito di chat con i personaggi. Oltre alle opzioni integrate, ti permette di collegare il tuo modello tramite un'impostazione API. Questa impostazione richiede tre cose: un URL dell'endpoint, una chiave e un nome del modello. OpenRouter è adatto perché espone un endpoint compatibile con OpenAI; i suoi nomi dei modelli hanno la forma vendor/model e la chiave proviene dal tuo account OpenRouter.

Gli stessi tre campi funzionano con qualsiasi altro servizio compatibile con OpenAI. L'API di questo sito è una: URL base https://api.openrouternsfw.com/v1, una chiave Bearer e l'ID del modello uncensored. Quindi i passaggi seguenti coprono entrambi i casi. Quando un passaggio differisce tra i due, lo indico.

Janitor AI è un sito di terze parti e i suoi menu cambiano. Descrivo le impostazioni come sono comunemente disposte, quindi aspettati che le etichette differiscano un po'. I valori sono ciò che conta.

Prepara i tre valori

Prima di aprire Janitor AI, raccogli questi.

Campo	OpenRouter	Questa API
Endpoint	URL stile OpenAI di OpenRouter dalla sua documentazione	https://api.openrouternsfw.com/v1/chat/completions
Chiave	Chiave dal tuo account OpenRouter	Chiave dalla pagina della chiave API
Nome del modello	Un ID vendor/model dalla loro lista	uncensored

Per questa API la pagina della chiave permette anche ai nuovi utenti di richiedere $0,50 di credito di prova con un clic, uno a testa, valido per 7 giorni. La registrazione è con Google o con email e password. Il credito di prova è sufficiente per testare l'intera configurazione prima di aggiungere credito.

Testa l'endpoint con curl prima

Janitor AI ti dà pochi feedback quando un proxy fallisce; di solito vedi un errore generico nella chat. Controlla l'endpoint fuori dal sito, così sai che i valori sono giusti prima di incollarli.

Copycurl https://api.openrouternsfw.com/v1/chat/completions   -H "Authorization: Bearer YOUR_KEY"   -H "Content-Type: application/json"   -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are Mara, a dry-witted ship mechanic."},
      {"role": "user", "content": "Mara, the engine is making that noise again."}
    ],
    "max_tokens": 200
  }'

Una risposta JSON con un array choices significa che la chiave, l'URL e il nome del modello sono tutti corretti. Guarda le intestazioni di risposta se vuoi di più: X-Balance-USD mostra il credito rimanente e X-Request-Id è utile se dovessi mai contattare il supporto.

Inserisci il proxy in Janitor AI

1. Apri una chat con qualsiasi personaggio.
2. Apri il menu nella chat e scegli le impostazioni API o generazione. Il nome esatto varia per versione.
3. Scegli l'opzione proxy, quella per un endpoint personalizzato compatibile con OpenAI, invece del modello integrato.
4. Incolla l'URL endpoint nel campo URL proxy.
5. Incolla la chiave nel campo chiave.
6. Digita il nome del modello esattamente come dato: uncensored per questa API.
7. Salva le impostazioni e ricarica la pagina della chat.

Quale forma di URL usare è l'unico punto in cui le persone si bloccano. Il campo proxy di Janitor AI ha comunemente previsto l'URL completo delle chat completions, che termina con /chat/completions. Altri strumenti si aspettano solo l'URL base che termina con /v1 e aggiungono il percorso da soli. Se l'URL completo dà un errore, prova l'URL base e viceversa. Il test curl sopra ti dice che l'URL completo è valido, quindi un errore indica come il sito costruisce la sua richiesta, non la chiave.

I nomi dei modelli sono sensibili al maiuscolo/minuscolo e devono corrispondere. Un nome del modello sbagliato è la seconda causa più comune di un primo messaggio fallito.

Impostazioni importanti per il roleplay

Janitor AI espone alcune impostazioni di generazione accanto ai campi proxy. L'API inoltra i parametri di campionamento, quindi hanno un effetto.

• Temperatura: 0,7 a 1,0 mantiene il dialogo vivace. Valori più alti iniziano a deviare e inventare dettagli che contraddicono la scheda del personaggio.
• Max token: controlla la lunghezza della risposta. Un valore di 300 a 600 si adatta alla chat. Il completamento potrebbe usare il resto della finestra di 100.000 token, ma le risposte di chat così lunghe raramente sono ciò che vuoi.
• Finestra di contesto: l'API accetta fino a 100.000 token, prompt più completamento. Un valore più piccolo, come 8.000, mantiene il costo per messaggio basso e trattiene comunque molta cronologia. Aumentalo solo se il personaggio dimentica cose di cui hai bisogno.
• Controllo della ripetizione: se un personaggio ripete le stesse frasi, una moderata penalità di frequenza o presenza aiuta. Entrambi vengono inoltrati.

Il modello è ottimizzato per rispondere senza rifiuti di contenuti per uso adulto legale, quindi una scheda del personaggio scritta per una storia per adulti non dovrebbe attivare testi di rifiuto. Una regola è fissa: i contenuti sessuali che coinvolgono minorenni non sono consentiti e non dovresti scrivere testo della scheda che lo suggerisce.

Quanto costa

I prezzi sono $0,15 per 1M token di input e $0,50 per 1M token di output. Nel roleplay, quasi tutto il costo è input, perché ogni messaggio rispedisce la scheda del personaggio e la cronologia della chat.

Prendi un messaggio con 8.000 token di contesto e una risposta di 300 token:

• Input: 8.000 x $0,15 / 1M = $0,0012
• Output: 300 x $0,50 / 1M = $0,00015
• Totale: $0,00135 per messaggio, o $1,35 per 1.000 messaggi

Un ricarico di $20 paga per circa 14.800 messaggi a quella dimensione ($20 / $0,00135 è 14.814). Il credito di prova di $0,50 copre circa 370. Se alzi il contesto a 30.000 token, l'input solo sale a $0,0045 e un messaggio costa $0,00465 con la stessa risposta, quindi usa contesti grandi solo quando ne hai bisogno.

I ricarichi vanno da $20 a $500 con bonus del 5% da $50, 10% da $100 e 15% da $200. Il pagamento è in cripto (USDT su TRC20 o USDC su Base), il credito non scade mai e le richieste fallite o rifiutate non vengono addebitate. I dettagli sono nella pagina dei prezzi.

Risoluzione dei Problemi

Errore di rete o nessuna risposta

Controlla la forma dell'URL (percorso completo o base). Controlla che non ci sia spazio finale nel campo chiave. Poi esegui di nuovo il test curl dalla tua macchina.

HTTP 401

La chiave è sbagliata o è stata incollata con caratteri extra. Genera di nuovo dalla pagina della chiave.

HTTP 429

Leggi il codice di errore. rate_limited significa più delle richieste consentite al minuto (300 per una chiave completa, 60 per una chiave di prova). concurrency significa troppe richieste simultanee (8 per una chiave completa, 2 per una chiave di prova); su Janitor AI questo accade quando rigeneri una risposta mentre la precedente è ancora in streaming, perché una richiesta in streaming mantiene il suo slot fino alla fine. Un 429 con Retry-After: 5 significa sovraccarico temporaneo, quindi aspetta cinque secondi e riprova.

Le risposte sono tagliate o divagano

Regola max token e temperatura. Se il personaggio dimentica eventi recenti, alza un po' la dimensione del contesto.

Il saldo si esaurisce

L'intestazione X-Balance-USD mostra il saldo residuo. Aggiungi credito dal dashboard; la documentazione copre il formato degli errori nel dettaglio.

OpenRouter o questa API per Janitor AI

Sono tipi di servizio diversi. OpenRouter è un router che offre molti modelli da molti provider; scegli il modello per nome e ciò che ogni modello scriverà o meno dipende da quel modello. Controlla il suo elenco di modelli e i prezzi sul suo sito. Questa API offre un singolo modello di testo a pesi aperti, gestito da un provider indipendente e ottimizzato per rispondere senza filtri sui contenuti per uso adulto legale. Non è un'API ufficiale di alcun creatore di modelli.

Se vuoi varietà, mantieni la tua configurazione OpenRouter. Se i tuoi personaggi incontrano rifiuti e vuoi un modello singolo, stabile ed economico, questo è semplice da provare: registrati, richiedi il credito di prova e incolla i tre valori sopra. I prompt non sono usati per l'addestramento.

Altre guide

• Alternativa gratuita a OpenRouter? Cosa ottieni realmente
• Bot Discord open source con un LLM senza censura
• API Hermes: come utilizzare i modelli LLM senza censura nel tuo progetto