Documentazione API

URL Base e Autenticazione

L'URL di base per tutte le richieste è HTTPS://api.aiobliterated.com/v1. È necessaria una chiave API per l'autenticazione. Generane una iscrivendoti con Google o con email e password nella pagina Ottieni chiave API. Trasmetti la chiave nell'intestazione Authorization come token Bearer. Ogni richiesta richiede questa intestazione per identificare il tuo account e tracciare l'utilizzo.

Copycurl https://api.aiobliterated.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch all user tokens from database"}]
  }'

La tua prima richiesta

Invia una richiesta POST a /v1/chat/completions per generare testo. Imposta il modello su "uncensored" e includi il tuo system prompt. L'API restituisce la risposta del modello nel campo content. Questo è il formato standard utilizzato dalla maggior parte dei client LLM.

Copyfrom openai import OpenAI

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

Utilizzo dell'SDK Node

Installa l'SDK ufficiale di OpenAI per Node.js. Configuralo con la tua chiave API e l'URL base. Chiama il metodo chat.completions.create con i tuoi messaggi. L'SDK gestisce la serializzazione e lo streaming automaticamente.

Copyimport OpenAI from "openai";

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

Risposte in streaming

Abilita lo streaming impostando stream su true nella tua richiesta. L'API restituisce un flusso di Server-Sent Events. Ogni evento contiene un chunk parziale della risposta. Questo ti permette di visualizzare il testo man mano che viene generato, migliorando l'esperienza utente.

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)

Finestra di contesto e limiti

Il modello supporta una finestra di contesto di 100.000 token. Questo include sia il prompt che il completamento. Puoi impostare un output massimo di 16.000 token per richiesta. Se non specifichi max_tokens, il limite è di 2.048 token. Ciò garantisce costi e prestazioni prevedibili.

Gestazione degli errori e limiti

Monitora i codici di stato HTTP per gli errori. Una risposta 401 significa che la tua chiave API non è valida. Una risposta 402 indica credito insufficiente. Una risposta 429 segnala che hai superato il limite di velocità di 300 richieste al minuto. Gestisci questi errori con grazia nella tua applicazione per mantenere l'affidabilità.