Installazione e configurazione
Inizia installando l'SDK ufficiale per il tuo linguaggio. Il client richiede solo la tua chiave API e l'URL di base corretto per instradare le richieste verso i nostri server. Questa configurazione funziona con qualsiasi client standard compatibile con OpenAI.
Configura le variabili d'ambiente o passale direttamente al costruttore del client. Non è necessario gestire la logica di routing complessa o passare tra più modelli. Il singolo modello uncensored gestisce tutte le richieste.
- Installa il pacchetto tramite il tuo gestore di pacchetti.
- Imposta la chiave API dal cruscotto.
- Indirizza il client all'endpoint dell'API.
Esecuzione della tua prima richiesta
Invia una richiesta POST all'endpoint di completamento della chat con l'ID del modello impostato su "uncensored". Questo restituisce una risposta testuale diretta dal modello, bypassando i filtri di contenuto standard. Puoi inviare prompt semplici o istruzioni di sistema complesse.
L'API accetta parametri standard come temperature e top_p. Usa il seguente comando cURL per verificare immediatamente la connettività e la qualità della risposta.
curl https://api.chatbotunrestricted.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Fetch current temperature in Tokyo."}]
}'Questa risposta conferma che il modello è attivo e pronto per il traffico di produzione.
Gestione delle risposte in streaming
Abilita lo streaming impostando il parametro stream su true. L'API restituisce uno stream di server-sent events (SSE), che consegna i token man mano che vengono generati. Questo riduce significativamente la latenza percepita per gli utenti finali.
Analizza gli chunk SSE per aggiornare la tua UI in tempo reale. L'ultimo chunk include l'utilizzo totale dei token per la richiesta. Questo approccio è essenziale per le interfacce chat dove gli utenti si aspettano feedback istantanei.
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)Assicurati che il tuo client gestisca correttamente l'evento di terminazione dello stream.
Utilizzo degli strumenti e del function calling
Definisci gli strumenti nella richiesta per consentire al modello di generare chiamate di funzioni strutturate. Passa le definizioni degli strumenti nell'array tools e specifica tool_choice per la selezione automatica. Il modello restituisce chiamate di funzione nel contenuto della risposta.
Analizza gli argomenti della funzione ed eseguili nel tuo codice. Quindi, passa i risultati al modello in un messaggio successivo. Questo ciclo consente flussi di lavoro complessi a più fasi senza logica di parsing esterna.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.chatbotunrestricted.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);Convalida sempre lo schema di output prima dell'esecuzione.
Gestione dei token e dei limiti
La finestra di contesto supporta 100.000 token per prompt e completamento combinati. Ogni richiesta può restituire fino a 16.000 token, o 2.048 se il parametro max_tokens è omesso. Monitora il tuo utilizzo tramite i conteggi dei token nella risposta.
I limiti di frequenza consentono 300 richieste al minuto e 8 richieste concorrenti per chiave. Il superamento di questi limiti attiva un errore 429. Mantieni la tua chiave unica per account per evitare di condividere i limiti.
Errori come 401 indicano una chiave non valida, mentre 402 significa che hai bisogno di più credito. I rifiuti per violazioni minori del contenuto sono gratuiti e non consumano token.
Gestione degli errori e risoluzione dei problemi
Gestisci gli errori HTTP in modo elegante nella logica della tua applicazione. Uno status 401 significa che la tua chiave API non è corretta o è scaduta. Controlla il tuo dashboard per assicurarti che la chiave sia attiva.
Un codice di stato 402 indica credito prepagato insufficiente. Aggiungi fondi utilizzando USDT o USDC per riprendere il servizio. L'errore 429 segnala che hai raggiunto il limite di velocità. Attendi e riprova con un backoff esponenziale.
I corpi della richiesta non validi restituiscono un errore 400. Verifica che la tua struttura JSON corrisponda alla specifica dell'API. Questi errori sono gratuiti e non deducono dal tuo saldo.
Python
from openai import OpenAI
client = OpenAI(base_url="https://api.chatbotunrestricted.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)