Configurazione API di SillyTavern: procedura di connessione compatibile con OpenAI
Spiego i punti critici della configurazione API di SillyTavern: endpoint, chiave, nome del modello e valore del contesto, insieme ai comandi di verifica.
Data di aggiornamento
Punti chiave
- Seleziona la modalità personalizzata Chat Completion (compatibile con OpenAI)
- URL: https://api.mukenetsuapi.com/v1, il nome del modello è uncensored
- Il contesto può arrivare a 100.000, ma è meglio limitarlo per costi e velocità
- 401 riguarda la chiave, 404 l'URL, 429 indica superamento del limite di concorrenza o delle richieste

Prepara i 3 elementi necessari
La configurazione API di sillytavern è breve; la maggior parte degli intoppi deriva da errori nei valori inseriti. Prepara prima questi 3 elementi.
- Chiave API: emettila dalla pagina di ottenimento della chiave API. Dopo la registrazione, ricevi $0,50 di credito di prova con un clic.
- URL base:
https://api.mukenetsuapi.com/v1 - Nome del modello:
uncensored
SillyTavern è un frontend che aggiunge endpoint compatibili con OpenAI. Essendo compatibile, non devi scegliere l'API ufficiale OpenAI: puoi registrarla come endpoint personalizzato.
Procedura di connessione
I testi del menu variano in base alla versione. Qui descrivo il flusso generale; se è diverso, consulta anche la documentazione ufficiale di SillyTavern.
- Apri "API Connections" (icona della presa) nella parte superiore.
- Seleziona "Chat Completion" come tipo di API.
- Dall'elenco delle sorgenti, scegli la connessione personalizzata (Custom) compatibile con OpenAI.
- Inserisci
https://api.mukenetsuapi.com/v1nell'URL dell'endpoint. Non aggiungere/chat/completionsalla fine. - Incolla la chiave emessa nel campo API Key, senza spazi prima o dopo.
- Imposta il nome del modello su
uncensored. Selezionalo dal menu o digitalo manualmente. - Clicca su Connetti e verifica che appaia il messaggio di successo.
Prima di connetterti, verifica terminale alla mano che chiave e URL siano corretti per facilitare il debug.
curl https://api.mukenetsuapi.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "uncensored", "messages": [{"role": "user", "content": "こんにちは"}], "max_tokens": 50}'Se ricevi una risposta, chiave, URL e modello sono corretti. Se SillyTavern fallisce in questo stato, il problema è nei dati inseriti dall'app.
Imposta contesto e lunghezza della risposta
La finestra di contesto di questa API supporta fino a 100.000 token combinando prompt e output. Tuttavia, non consiglio di impostare il contesto al massimo in SillyTavern: ogni volta invii impostazioni personaggio, lore e cronologia, quindi valori più alti aumentano il costo per input.
Esempio di calcolo dei costi
Se usi 16.000 token di contesto e la risposta è di 300 token, il costo per messaggio è:
- Input: 16.000 ÷ 1.000.000 × $0,15 = $0,0024
- Output: 300 ÷ 1.000.000 × $0,50 = $0,00015
- Totale: $0,00255
Costa $0,255 per 100 messaggi. dimezzando il contesto a 8.000, il lato input si riduce di circa la metà. Per i dettagli sul prezzo unitario, visita la pagina dei prezzi.
Stime
Se non si tratta di storie lunghe o scene con molti personaggi, è realistico iniziare con 8.000 o 16.000 e aumentare solo se si ha la sensazione che il personaggio dimentichi gli eventi passati. La lunghezza massima della risposta deve essere adattata alla lunghezza che si desidera leggere come singola risposta. max_tokens è facoltativo, ma è consigliabile impostare un limite lato SillyTavern se si vogliono evitare risposte troppo lunghe.
Logica delle impostazioni di campionamento
temperature, top_p, stop, seed e le varie penalità vengono passate direttamente all'API. È possibile modificarle tramite i preset di SillyTavern.
- Ripetizione delle stesse espressioni: aumentare leggermente le penalità di frequency e presence.
- Risposta dispersiva: abbassare la temperature.
- Monotonia: aumentare leggermente la temperature.
- Confronto: fissare il seed e modificare i valori un alla volta.
I nomi dei campi del preset variano in base alla versione di SillyTavern. Se le impostazioni non vengono applicate, verificare se il metodo di connessione supporta quel campo o consultare la documentazione di SillyTavern.
Errori comuni e soluzioni
| Sintomi | Possibili cause | Soluzioni |
|---|---|---|
| 401 | Chiave errata o spazi inclusi | Incolla di nuovo la chiave e prova a usarla con curl. |
| 404 | URL errato | Verifica che termini con /v1. |
| Modello non trovato | Ortografia del nome del modello | Inseriscilo in minuscolo come uncensored. |
429 (concurrency) | Troppe richieste parallele | Riduci gli swipe ripetuti o la generazione simultanea nelle chat di gruppo. |
429 (rate_limited) | Superato il numero massimo di richieste al minuto | Attendi un attimo. |
429 (con Retry-After: 5) | Congestione temporanea | Attendi 5 secondi e riprova. |
Limite chiave completa: 8 concorrenti, 300/min. Chiave prova: 2 concorrenti, 60/min. Lo streaming occupa 1 slot fino al termine. Con la chiave prova, il gruppo chat esaurisce subito i limiti.
Puoi verificare se il saldo è sufficiente con il comando seguente.
curl https://api.mukenetsuapi.com/v1/balance \
-H "Authorization: Bearer YOUR_API_KEY"Puoi leggerlo anche dall'intestazione di risposta X-Balance-USD. Per verificare l'elenco dei modelli usa GET /v1/models.
curl https://api.mukenetsuapi.com/v1/models \
-H "Authorization: Bearer YOUR_API_KEY"Avvertenze sull'uso
Questa API è solo per il testo. Se vuoi usare le funzioni di generazione immagini o audio di SillyTavern, ti serviranno altri servizi. Il contenuto è pensato per l'uso adulto legale, come romanzi, roleplay o app companion. Non sarà possibile generare contenuti sessuali con minorenni, indipendentemente dalle impostazioni. I prompt non vengono utilizzati per l'addestramento del modello.
Per i parametri più dettagliati, consulta la documentazione. I pagamenti sono in USDT (TRC20) o USDC (Base) in importi interi da $20 a $500.
Altre guide
Domande frequenti
Qual è il nome del modello da usare con SillyTavern?
uncensored. Inseriscilo in minuscolo, esattamente così.
È necessario aggiungere /chat/completions alla fine dell'URL?
Non è necessario. L'URL base termina con /v1; il resto del percorso viene aggiunto dall'app.
La chiave di prova è sufficiente?
È sufficiente per verificare la connessione o conversazioni brevi. Tuttavia, la chiave di prova è limitata a 2 richieste parallele e 60 al minuto, con validità di 7 giorni: ricarica una chiave standard se usi chat di gruppo.
È possibile generare anche immagini?
No. Questa API è solo per il testo e non supporta la generazione di immagini, audio o video.
A quanti token dovrebbe essere impostato il contesto?
Il massimo è 100.000 token, ma è più realistico iniziare con 8.000-16.000. Volumi maggiori aumentano l'input per ogni richiesta, incrementando i costi.
Ottieni la chiave API con un solo modulo
Crea l'account, copia la chiave e modifica l'URL base. È tutto ciò che serve per configurare tutto.