Guida Rapida all'Integrazione API

Autenticazione e Base URL

Per consumare la nostra API intelligenza artificiale, avrai bisogno di una chiave API e dell'URL base corretto. Registrati nella pagina Get API key con email e password per ottenere la tua chiave immediatamente; non è richiesta la carta per la prova. Usa l'URL base https://api.llmsincensura.com/v1 con qualsiasi client compatibile con OpenAI. L'autenticazione avviene inviando la tua chiave nell'intestazione Authorization: Bearer YOUR_API_KEY. Questo metodo standard assicura che il tuo LLM senza censura funzioni con gli strumenti che già conosci.

Il modello che utilizzerai è uncensored. Assicurati di configurarlo nelle tue richieste. Non ci sono percorsi complessi; invii testo e ricevi testo grezzo. Se la tua applicazione richiede un endpoint specifico, questo è l'unico che ti serve per la chat. La semplicità è la chiave per un'integrazione rapida e senza attriti.

Endpoint /v1/chat/completions

Il cuore della API AI uncensored è l'endpoint di completamento chat. Invia una lista di messaggi (system, user, assistant) e ricevi una risposta completa. Questo approccio diretto evita i rifiuti di contenuto comuni in altri modelli per temi adulti o controversi. La struttura JSON è identica a quella di OpenAI, facilitando il passaggio se vieni da un'altra piattaforma.

Ricorda che supportiamo solo questo endpoint per il testo. Non ci sono embedding né generazione di immagini. Per iniziare, puoi provare una richiesta semplice con curl per verificare che la tua chiave funzioni e che la risposta arrivi senza filtri.

Copiarcurl https://api.llmsincensura.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Integrazione con Python

Gli sviluppatori Python possono usare la libreria ufficiale openai adattando l'URL base. Questo permette di sfruttare l'ecosistema esistente di strumenti e SDK. Configura la chiave e il base_url per puntare ai nostri server. Il modello uncensored elaborerà il tuo input mantenendo il contesto fino a 100.000 token.

Questa configurazione è ideale per script di automazione o applicazioni backend che necessitano di risposte rapide e senza censura. La velocità di risposta è solitamente elevata grazie all'infrastruttura dedicata sui nostri server GPU.

Copiarfrom openai import OpenAI

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

Integrazione con Node.js

Nell'ecosistema JavaScript/Node, l'integrazione è altrettanto diretta. Usa l'SDK di OpenAI e sovrascrivi l'URL base. Questo permette alle applicazioni web o server Node di consumare IA senza restrizioni senza cambiare la logica del tuo codice esistente. La gestione degli errori e delle promesse funziona esattamente come ti aspetti con altri client OpenAI.

È importante ricordare che il modello non è GPT né Claude, ma un modello open-weight ottimizzato specificamente per questo servizio. Questo garantisce coerenza nel comportamento senza filtri. Configura le variabili d'ambiente per mantenere la tua chiave sicura in produzione.

Copiarimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.llmsincensura.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 con SSE

Per migliorare l'esperienza utente, abilita lo streaming impostando stream: true nella tua richiesta. Riceverai frammenti di testo man mano che vengono generati, riducendo la latenza percepita. Questo è cruciale per le applicazioni di chat in tempo reale dove gli utenti si aspettano di vedere la risposta lettera per lettera.

Lo streaming mantiene le stesse proprietà di non filtraggio delle risposte complete. Puoi elaborare questi frammenti lato client o lato server per renderizzare la risposta progressivamente. È il modo migliore per mostrare la potenza di una chat IA senza censura nelle applicazioni interattive.

Copiarstream = 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 e Gestione Errori

La tua chiave ha un limite di 300 richieste al minuto. Se superi questa soglia, riceverai un errore 429. C'è anche un limite del corpo della richiesta di 8 MB. Se la tua chiave non è valida, otterrai un 401; se non hai credito, un 402. Il contesto massimo è di 100k token combinati (prompt + risposta).

L'unica restrizione di contenuto rigorosa è il divieto di contenuti sessuali con minori, che si applica sempre. Per gli altri temi, il modello è molto permissivo. Controlla i codici di errore standard di OpenAI per risolvere rapidamente i problemi di integrazione.