IT ▾
Ottieni la chiave API

Chiave API di Janitor AI non funziona: guida passo dopo passo

Se la tua chiave API di Janitor AI non funziona, il problema è quasi sempre in uno dei cinque campi o nell'account associato alla chiave. Segui i passaggi seguenti in ordine e lo troverai senza indovinare.

Aggiornato

Bolla di chat collegata a una chiave luminosa da un cavo con un collegamento rotto in fase di riparazione
Bolle di chat che passano attraverso pannelli di filtro verso un terminale, mostrando dove risiedono i filtri

Passo 1: conferma che la chiave funziona

Escludi Janitor AI. Esegui questo in un terminale, sostituendo YOUR_KEY:

curl -i https://api.nofilterapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Reply with the word ready."}]}'

Uno stato 200 e un array choices significano che la chiave, l'URL e il nome del modello sono corretti. L'intestazione X-Balance-USD mostra il tuo credito residuo. Se funziona, salta al passo 3, perché il problema è nella configurazione di Janitor AI. Se fallisce, il codice di stato ti dice cosa correggere e la tabella nel passo 2 associa i codici alle cause.

Non hai un terminale a portata di mano? Qualsiasi strumento di test API in grado di inviare un POST con intestazioni fa lo stesso lavoro.

Passo 2: leggi il codice di stato

Stato o messaggioSignificatoSoluzione
401Chiave non accettataRicopia la chiave dalla pagina delle chiavi; rimuovi gli spazi; controlla che l'intestazione dica Bearer seguita dalla chiave
404Percorso URL inesistenteUsa esattamente https://api.nofilterapi.com/v1/chat/completions, senza segmenti extra
Errore del modelloNome non riconosciutoImposta il modello su uncensored
Errore di saldo o pagamentoNessun credito rimasto o prova scadutaRicarica da $20, oppure richiedi la prova se non l'hai ancora fatto
429 rate_limitedSuperato il limite per minutoAttendi un minuto; chiave di prova 60 al minuto, chiave completa 300
429 concurrencyTroppe richieste contemporaneamenteChiudi le schede e le chat extra; chiave di prova 2, chiave a pagamento 8
429 con Retry-After: 5Sovraccarico temporaneoAttendi cinque secondi e premi rigenera

Le richieste fallite o rifiutate non vengono addebitate, quindi il test non costa nulla. Modifica una cosa alla volta tra i test. Se modifichi l'URL, la chiave e il nome del modello contemporaneamente e tutto inizia a funzionare, non saprai quale fosse l'errore e commetterai lo stesso errore anche la volta successiva.

Passo 3: inserisci le impostazioni in Janitor AI

In una chat, apri le impostazioni API e scegli l'opzione proxy, che è il modo in cui Janitor AI si connette al tuo endpoint compatibile con OpenAI. I nomi dei menu variano tra le versioni, quindi abbina per scopo. Hai bisogno di tre valori.

  1. Nome del modello: uncensored
  2. URL proxy: https://api.nofilterapi.com/v1/chat/completions. Il campo proxy di Janitor AI si aspetta generalmente l'endpoint completo piuttosto che il solo base. Se un tuo strumento richiede un URL base, usa https://api.nofilterapi.com/v1.
  3. Chiave API: la tua chiave, incollata senza spazi prima o dopo.

Salva le impostazioni, quindi ricarica la pagina. Una causa comune di "fallisce ancora" è che i nuovi valori non sono mai stati salvati o la chat sta ancora usando la connessione precedente. Avvia un nuovo messaggio dopo il ricaricamento, non una rigenerazione su uno vecchio fallito.

Errori tipici, in ordine di frequenza

  • URL base dove è necessario l'endpoint completo. Senza /chat/completions, la richiesta raggiunge un percorso inesistente e restituisce 404.
  • Percorso duplicato. Incollare /v1/chat/completions dopo un URL che termina già in /v1 dà /v1/v1/....
  • Nome del modello di un altro servizio. Nomi come gpt-4 non esistono qui. L'unico ID è uncensored.
  • Chiave dal posto sbagliato. Le chiavi di altri servizi non funzioneranno. Usa la chiave dalla pagina delle chiavi API per questa.
  • Caratteri nascosti. Copiare da un'app di chat o da un documento può aggiungere uno spazio finale o un a capo. Incolla in un campo di testo semplice prima e controlla.
  • Virgolette extra. Non racchiudere la chiave o l'URL tra virgolette.

Quando funziona una volta e poi fallisce

Gli errori intermittenti indicano solitamente limiti o saldo, non la chiave.

Concurrency. Una chiave trial permette due richieste simultanee e 60 al minuto. Una chiave completa permette otto e 300. Se rigeneri una risposta mentre la precedente è ancora in streaming, o hai il personaggio aperto in due schede, puoi raggiungere concurrency. Una richiesta in streaming mantiene la sua slot fino al termine dello streaming.

Dimensione del contesto. La finestra è di 100.000 token, prompt più completamento. Janitor AI ha la propria impostazione del contesto, e le chat lunghe con carte personaggio grandi possono riempirla. Se le risposte si interrompono o la richiesta genera errori solo nelle chat lunghe, riduci l'impostazione del contesto o riassumi la cronologia.

Saldo. La prova è di $0,50, valida per 7 giorni. Quando si esaurisce o scade, le richieste falliscono fino all'aggiunta di credito. Un tipico turno di roleplay con 6.000 token di input e 400 token di output costa 6.000 / 1.000.000 x $0,15 + 400 / 1.000.000 x $0,50, che è $0,0009 più $0,0002, o $0,0011. La prova copre circa 450 turni se nulla altro interferisce.

Impostazioni da regolare una volta stabilita la connessione

Dopo la prima risposta, alcune impostazioni migliorano i risultati ed evitano nuovi errori.

  • Max new tokens. Imposta un limite di risposta adatto allo stile di chat, ad esempio 300-600 token. È opzionale lato API, ma un limite impedisce alle risposte di continuare e mantiene il costo dell'output a $0,50 per 1M di token.
  • Temperatura. Valori tra 0,7 e 1,0 sono adatti per il roleplay. Se le risposte diventano incoerenti, abbassala. L'API trasmette temperatura, top_p, stop, seed e le penalità di ripetizione.
  • Dimensione del contesto. Abbinala alle tue esigenze. La finestra permette fino a 100.000 token, ma inviare molto più del necessario alla storia aumenta solo il costo di ogni turno.
  • Streaming. Se le tue risposte appaiono tutte insieme o lo streaming si blocca, prova a commutare lo streaming. L'API supporta gli eventi inviati dal server.

Se il personaggio rifiuta ancora una scena, la causa è solitamente la carta del personaggio o un system prompt scritto per un modello più rigoroso, non la chiave. Rivedi cosa dice la carta al modello. Il modello è ottimizzato per rispondere senza rifiuti di contenuti per uso adulto legale, con un limite fisso: nulla che coinvolga i minori.

Aggiungere credito e ottenere una nuova chiave

Apri la pagina prezzi per ricaricare: qualsiasi importo intero da $20 a $500, con +5% da $50, +10% da $100 e +15% da $200. Puoi pagare con carta (Visa, Mastercard, Apple Pay, Google Pay) o cripto (USDT su TRC20, USDC su Base). Il credito non scade mai.

Non hai ancora un account? Iscriviti con Google, oppure con email e password, poi richiedi il credito di prova gratuito nella pagina della chiave API. È uno per persona e non richiede carta. Se sospetti che la tua chiave sia stata compromessa, ad esempio perché hai pubblicato uno screenshot, creane una nuova invece di fare il debug di quella vecchia.

Ancora bloccato? Prova con uno script

Questo script stampa l'errore reale, più informativo di un messaggio generico in un'interfaccia web:

from openai import OpenAI, APIStatusError

client = OpenAI(base_url="https://api.nofilterapi.com/v1", api_key="YOUR_KEY")
try:
    r = client.chat.completions.create(
        model="uncensored",
        messages=[{"role": "user", "content": "Say hello as a pirate captain."}],
    )
    print(r.choices[0].message.content)
except APIStatusError as e:
    print(e.status_code, e.response.text)
    print("request id:", e.response.headers.get("X-Request-Id"))

Se ha successo, l'account è sano e il problema è puramente un campo di Janitor AI. Se fallisce, il codice di stato corrisponde alla tabella sopra. Mantieni l'ID richiesta quando scrivi al supporto. La documentazione elenca tutti i parametri supportati. Se sei curioso di sapere come funziona il filtro su Janitor AI stesso, leggi se Janitor AI ha un filtro. Per maggiori informazioni sul tipo di modello alla base di questa chiave, consulta la pagina chatbot AI senza filtri sui contenuti. L'API serve solo testo e i contenuti sessuali che coinvolgono minorenni non sono mai consentiti.

Domande e risposte

Quale URL proxy devo usare in Janitor AI?

Usa https://api.nofilterapi.com/v1/chat/completions se il campo vuole l'endpoint completo. Uno strumento che richiede un URL di base prende https://api.nofilterapi.com/v1.

Quale nome del modello devo inserire?

Inserisci uncensored in minuscolo. È l'unico ID del modello disponibile.

Perché ricevo un errore 429?

Hai superato un limite. Il codice rate_limited indica troppe richieste al minuto, concurrency indica troppe richieste simultanee e un Retry-After di 5 indica un sovraccarico breve.

Le richieste fallite consumano il mio credito?

No. Le richieste fallite o rifiutate non vengono addebitate.

La tua chiave è a un modulo di distanza

Crea un account, copia la chiave, modifica l'URL di base. È tutta la configurazione.