Guida all'Integrazione: API Chat Completions

URL Base e Autenticazione

L'API abliterata funziona come sostituzione diretta degli endpoint OpenAI standard. Inoltri le richieste a https://api.aiabliterated.cc/v1 e autenticarti utilizzando un token Bearer nell' Authorization header. Questa configurazione funziona con qualsiasi client che supporta il protocollo OpenAI.

• Base URL: https://api.aiabliterated.cc/v1
• Intestazione Auth: Authorization: Bearer YOUR_API_KEY
• ID modello: uncensored

L'autenticazione è rigorosa. Se invii una chiave non valida, il sistema restituisce immediatamente un errore 401.

L'endpoint /v1/chat/completions

Invia i dati del prompt a /v1/chat/completions endpoint per ricevere risposte testuali. Il sistema si aspetta un payload JSON contenente l'identificatore del modello e la cronologia dei messaggi. Questa è un'interfaccia solo testo; non aspettarti generazione di immagini o audio.

Il modello elabora input e output all'interno di una finestra di contesto di 100.000 token. Se non specifichi un limite, il sistema genera per impostazione predefinita 2.048 token per richiesta. Puoi aumentare questo valore fino a un massimo assoluto di 16.000 token.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.aiabliterated.cc/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)

Risposte in streaming e utilizzo dei token

Abilita lo streaming impostando stream: true nel payload della richiesta. L'API restituisce un flusso di Server-Sent Events (SSE) di token parziali. Questo riduce significativamente la latenza percepita per le applicazioni interattive.

I dati sull'utilizzo dei token non vengono inviati con ogni chunk. Invece, l'ultimo chunk dello stream contiene le statistiche complete di utilizzo per quella richiesta. Questo design mantiene lo stream leggero fornendo al contempo dati di fatturazione accurati. Gli errori durante lo streaming vengono gestiti chiudendo la connessione con un oggetto JSON di errore.

Copystream = 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)

Function Calling e modalità JSON

Il modello abliterato supporta output strutturati tramite il response_format parametro. Imposta questo su {"type": "json_object"} per forzare una stretta conformità JSON. Questo è essenziale per un'integrazione affidabile con i sistemi backend.

Il function calling è anche disponibile. Definisci gli strumenti nella tua richiesta e il modello produrrà JSON valido corrispondente al tuo schema. Il sistema non convalida le tue definizioni degli strumenti, quindi assicurati che i tuoi schemi siano corretti prima di inviare le richieste. Questa capacità consente architetture di agenti complessi senza livelli di parsing esterni.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.aiabliterated.cc/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);

Parametri: Temperatura, Top-P e Seed

Controlla la casualità dei tuoi output utilizzando parametri di campionamento standard. Il temperature valore regola la creatività, mentre top_p limita il campionamento del nucleo. Usa seed per output deterministici quando hai bisogno di risultati riproducibili per il debug.

Altri parametri disponibili includono stop sequenze, presence_penalty, e frequency_penalty. Questi permettono un controllo raffinato sulla ripetizione dei token e sull'aderenza all'argomento. Il modello uncensored risponde bene a impostazioni di temperatura bassa per la generazione di codice e a temperature alte per la scrittura creativa.

Limiti di frequenza e vincoli

L'API impone limiti rigorosi per garantire la stabilità per tutti gli utenti. Sei limitato a 300 richieste al minuto per chiave. Le richieste concorrenti sono limitate a 8 simultanee. Il corpo di ogni richiesta non deve superare gli 8 MB.

Se superi questi limiti, il sistema restituisce un errore 429 Too Many Requests. La fatturazione si basa sull'utilizzo reale dei token. Errori e rifiuti non consumano il tuo credito prepagato. Puoi gestire la tua chiave direttamente dal dashboard se devi ruotare le credenziali a causa di questi vincoli.

cURL

Copycurl https://api.aiabliterated.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize this 500 word technical document"}]
  }'