Documentazione API

URL Base e Autenticazione

L'API vive a https://api.ollamauncensoredmodels.com/v1Autorizzazione header con il tuo token Bearer. Questa configurazione funziona con qualsiasi libreria client compatibile con OpenAI perché aderiamo agli stessi pattern di autenticazione. Puoi generare la tua chiave istantaneamente tramite Google o email senza fornire il numero di telefono. Il sistema emette una chiave attiva per account, sostituendo qualsiasi chiave precedente immediatamente alla generazione. Questo garantisce un accesso coerente senza la necessità di gestire più credenziali simultaneamente.

Esecuzione della tua prima richiesta

Invia una richiesta POST a /v1/chat/completions con l'ID del modello impostato su "uncensored". L'endpoint accetta parametri standard come messages, temperature, e max_tokens. Restituisce risposte JSON contenenti il testo generato e le statistiche sull'utilizzo dei token. Puoi testare la connettività rapidamente verificando l'elenco dei modelli o inviando un prompt semplice. Questo approccio diretto rimuove la complessità della logica di proxy o routing spesso presente in altri servizi.

Copycurl https://api.ollamauncensoredmodels.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the output for 2 plus 2"}]
  }'

Integrazione SDK Python

Utilizza la libreria Python ufficiale di OpenAI per connettersi sovrascrivendo l'URL di base. Imposta gli attributi della chiave API e dell'URL di base prima di effettuare qualsiasi chiamata. Questo ti permette di sfruttare i codici esistenti senza riscrivere la logica del client. La libreria gestisce automaticamente la serializzazione e l'analisi degli errori. Puoi trasmettere le risposte o richiedere completamenti sincroni a seconda dei requisiti di latenza della tua applicazione. Questo metodo garantisce la compatibilità con le pratiche di sviluppo standard utilizzate in tutto il settore.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.ollamauncensoredmodels.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 SDK Node.js

Inizializza il client OpenAI con il tuo URL di base e la chiave API negli ambienti Node.js. Passa l'identificatore del modello "uncensored" al metodo delle chat completions. Il SDK gestisce le richieste HTTP e analizza le risposte JSON in modo efficiente. Puoi integrarlo direttamente nelle route Express o nelle funzioni serverless. La struttura del codice riflette le implementazioni standard di OpenAI, rendendo la migrazione da altri provider semplice. Questo approccio mantiene la sicurezza dei tipi e la gestione degli errori coerenti con lo sviluppo JavaScript moderno.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.ollamauncensoredmodels.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 e Utilizzo dei Token

Abilita lo streaming impostando stream: true nella tua richiesta. Il server restituisce Server-Sent Events (SSE) per la consegna dei token in tempo reale. I dettagli sull'utilizzo dei token appaiono solo nell'ultimo chunk dello stream per mantenere il sovraccarico minimo. Questo ti consente di visualizzare le risposte in modo progressivo agli utenti senza attendere l'intera generazione. Puoi monitorare i conteggi cumulativi dei token per la trasparenza della fatturazione. Lo streaming è ideale per le interfacce chat in cui il feedback immediato migliora significativamente 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)

Limiti, Errori e Contesto

Ogni chiave API supporta 300 richieste al minuto e otto connessioni concorrenti. Il limite di dimensione del corpo della richiesta è di 8 MB e la finestra di contesto copre 100,000 token in totale. Errori come 401 indicano una chiave non valida, mentre 402 segnala credito insufficiente. Uno status 429 significa che hai raggiunto il limite di frequenza. Il modello rifiuta solo i contenuti sessuali che coinvolgono minori, garantendo ampia applicabilità per i casi d'uso adulti. Il credito non scade mai, quindi puoi mettere in pausa l'utilizzo tra i progetti senza perdere fondi. Questa struttura prevedibile ti aiuta a pianificare la capacità per le applicazioni ad alto traffico in modo efficace.