uncensoredroleplayai.com/Documenti
Avvio Rapido API AI Non Censurata
Ottieni un'istanza AI per roleplay senza filtri attiva in pochi minuti con la nostra API compatibile con OpenAI. Utilizza SDK standard per inviare testo e ricevere risposte a lungo contesto senza filtri di contenuto.
Prerequisiti e configurazione dell'URL di base
Inizia registrando un account tramite Google o email nella pagina delle chiavi. La tua chiave API appare immediatamente e funge da unica credenziale per tutte le richieste. L'URL base del servizio è https://api.uncensoredroleplayai.com/v1, che funziona con qualsiasi client compatibile con OpenAI.
Configura la tua variabile di ambiente o il client SDK per puntare a questo URL. Questo singolo endpoint gestisce tutte le completamenti di testo. Non hai bisogno di gestire il routing dei modelli o selezionare tra più fornitori. L'identificatore del modello è sempre uncensored, un modello open-weight ottimizzato per contenuti per adulti e di finzione.
Autenticazione con chiavi API
Includi la tua chiave API nel Authorization header come token Bearer. Ogni richiesta deve contenere questo header per autenticare la tua identità. Se la chiave è mancante o non valida, il server restituisce un errore 401 Unauthorized. Controlla la dashboard del tuo account se sospetti che la chiave sia stata revocata.
Ogni account contiene una chiave attiva alla volta. Generare una nuova chiave sostituisce immediatamente quella vecchia. Non c'è limite al numero di chiavi che puoi generare storicamente, ma solo quella corrente funziona. Usa questa singola chiave su tutti i tuoi servizi.
Invio della tua prima completazione chat
Effettua una richiesta POST a /v1/chat/completions endpoint. endpoint. Passa il nome del modello uncensored e la cronologia della tua conversazione nel messages array. Il sistema restituisce una risposta testuale senza filtrare gli argomenti adulti leciti.
- Imposta il modello su
uncensored. - Includi il tuo prompt di sistema per definire la persona di roleplay.
- Invia i messaggi utente per far progredire la narrazione.
Verifica che la struttura della risposta contenga il testo generato. Questo conferma che la tua integrazione funziona correttamente con l'API LLM senza filtri.
Gestione delle risposte in streaming
Abilita lo streaming impostando stream a true nella tua richiesta. L'API invia chunk tramite Server-Sent Events (SSE). Ogni chunk contiene testo parziale e metadati. Elaborazione questi chunk in tempo reale per visualizzare la risposta man mano che viene generata.
I dettagli sull'utilizzo dei token appaiono nell'ultimo chunk. Questo ti permette di monitorare i costi con precisione senza attendere l'intera risposta. Lo streaming è ideale per i bot di roleplay dove la latenza è importante. Usa l'SDK Node per gestire facilmente questi eventi.
Configurazione dei parametri per il roleplay
Regola parametri come temperature e top_p per controllare la creatività. Temperature più alte producono output più diversificati e imprevedibili. Usa stop sequenze per terminare le risposte a frasi specifiche. La modalità JSON è disponibile tramite response_format per dati strutturati.
Imposta max_tokens per controllare la lunghezza dell'output. Il valore predefinito è 2.048 token, ma puoi richiedere fino a 16.000. La finestra di contesto supporta 100.000 token totali. Questo permette la continuità di testi lunghi senza perdere il contesto. Sintonizza questi parametri per il tuo caso d'uso specifico.
Comprendere l'utilizzo e il prezzo dei token
I prezzi sono trasparenti: $0.15 per milione di token di input e $0.50 per milione di token di output. Errori e rifiuti sono gratuiti. Il credito è prepagato e non scade. Ricarica tramite criptovalute con USDT (TRC20) o USDC (Base).
I limiti includono 300 richieste al minuto e 8 richieste concorrenti per chiave. La dimensione del corpo della richiesta è limitata a 8 MB. Se rimani senza credito, ricevi un errore 402 Payment Required. Monitora il tuo utilizzo tramite la dashboard per evitare interruzioni.
cURL
curl https://api.uncensoredroleplayai.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Summarize the main plot points of the provided story text"}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredroleplayai.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.uncensoredroleplayai.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);Streaming
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)Domande e risposte tecniche
Qual è il limite di contesto dell'AI per roleplay senza censure?
La finestra di contesto supporta 100.000 token sia per il prompt che per il completamento. Puoi generare fino a 16.000 token per richiesta. Ciò consente narrazioni di lunga durata senza perdere il contesto. Si applicano ancora i rifiuti per contenuti sessuali minori.
Come gestisco gli errori di autenticazione?
Un errore 401 indica una chiave API non valida o mancante. Controlla la dashboard del tuo account per assicurarti che la chiave sia attiva. Genera una nuova chiave se quella vecchia è stata revocata. Ogni account può avere una sola chiave attiva alla volta.
Cosa succede se supero il limite di frequenza?
Riceverai un errore 429 Too Many Requests. Il limite è di 300 richieste al minuto e 8 richieste concorrenti. Attendi qualche secondo prima di riprovare. Monitora il tuo utilizzo per rimanere entro i limiti.
Recupera la tua chiave API
Registrati, copia il token, aggiorna l'endpoint. È l'intera configurazione.