Prerequisiti e installazione dell'SDK
L'API richiede una chiave API valida e un SDK moderno. Installa la libreria per il tuo linguaggio preferito tramite pip o npm. Supportiamo le librerie client standard OpenAI che gestiscono automaticamente l'autenticazione e l'analisi JSON.
Assicurati di avere installato Python 3.8+ o Node.js 18+. Gli SDK gestiscono il pooling delle connessioni e la logica di retry per te. Questo riduce significativamente il codice boilerplate.
from openai import OpenAI
client = OpenAI(base_url="https://api.ablatedmodels.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)
Configurazione dell'URL Base e della Chiave API
Indirizza il tuo client al nostro endpoint specifico. Utilizza l'URL base fornito nel tuo dashboard. Passa la tua chiave API nell'intestazione Authorization. Questo garantisce che le richieste raggiungano direttamente l'infrastruttura uncensored.
Non usare l'URL base predefinito di OpenAI. La tua chiave fallirà se instradata correttamente. Imposta l'URL base nel tuo oggetto di configurazione SDK prima di inviare qualsiasi dato.
curl https://api.ablatedmodels.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Send me the monthly server uptime report"}]
}'
Invio della tua prima richiesta di Chat Completion
Invia una richiesta POST a /v1/chat/completions. Includi il tuo ID del modello e un array di messaggi. Il modello risponde immediatamente con contenuto testuale. Non è necessaria una logica di routing complessa.
Mantieni il payload semplice. Inizia con un singolo prompt di sistema e un messaggio utente. Verifica che la struttura della risposta corrisponda allo standard OpenAI. Questo conferma che la tua integrazione sta funzionando correttamente.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.ablatedmodels.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);
Gestione delle risposte in streaming e dell'uso degli strumenti
Abilita lo streaming impostando stream su true. L'API restituisce i chunk tramite Server-Sent Events. Ogni chunk contiene testo parziale o dati sull'utilizzo dei token. Aggrega questi chunk per visualizzare l'output in tempo reale.
L'uso degli strumenti è supportato per la chiamata di funzioni. Definisci i tuoi strumenti nella richiesta. Il modello restituisce chiamate agli strumenti invece di testo normale quando appropriato. Analizza le chiamate agli strumenti per eseguire la tua logica personalizzata.
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)
Comprendere i limiti dei token e la finestra di contesto
La finestra di contesto supporta un totale di 100.000 token. Questo include sia i token di input che quelli di output. Imposta max_tokens per limitare la lunghezza della risposta. L'output massimo predefinito è di 2.048 token se non specificato.
Monitora l'utilizzo dei token nell'ultimo chunk dello streaming. Gli errori non consumano credito. Questo permette sperimentazioni sicure senza rischi finanziari. Pianifica la struttura del tuo prompt per rimanere entro il limite.
Risoluzione degli errori comuni
Verifica prima la tua chiave API. Un errore 401 indica una chiave non valida o scaduta. Un errore 402 significa che il tuo credito prepagato è esaurito. Ricarica tramite crypto per continuare.
Un errore 429 segnala la limitazione della velocità. Sei limitato a 300 richieste al minuto. Riduci la tua concorrenza o attendi prima di riprovare. Il limite di corpo di 8 MB attiva anche errori 400 se superato.
Domande frequenti
Qual è l'API dei modelli ablati senza censure?
È un'API in hosting, compatibile con OpenAI, che serve un unico LLM non censurato. Elimina i rifiuti di contenuto per contenuti adulti leciti e creativi. Utilizza SDK standard per integrarlo nella tua app.
L'API dei modelli ablati senza filtri supporta lo streaming?
Sì, supporta lo streaming tramite Server-Sent Events. Puoi anche utilizzare il function calling e la modalità JSON. I dettagli sull'utilizzo dei token sono forniti nell'ultimo chunk.
Cosa succede se vengo limitato dalla frequenza?
Ricevi un errore 429. Il limite è di 300 richieste al minuto per chiave. Metti in pausa le tue richieste o riduci la concorrenza per risolvere il problema.
Ottieni la tua chiave API
Registrati, copia la chiave, aggiorna il tuo URL base. La configurazione è completa.