Documentazione API Uncensored

Avvio rapido: invia la tua prima richiesta

L'API Unzensierte è un servizio compatibile con OpenAI. Paghi per token per la generazione di testo senza filtri dei contenuti. Invia una richiesta POST all'endpoint di completamento chat con la tua chiave API. Il modello elabora il tuo prompt e restituisce direttamente l'output testuale.

Inizia autenticando con la tua chiave. Poi definisci l'ID del modello come "uncensored". Specifica il tuo array di messaggi con un ruolo e un contenuto. Il server risponde con il testo generato. Questo funziona con qualsiasi client HTTP o SDK standard. Ottieni testo grezzo, senza overhead di formattazione aggiuntivo. Gli errori restituiscono JSON con un codice di errore. Usa questo percorso rapido per verificare la tua configurazione prima di costruire applicazioni complesse.

Autenticazione e URL di base

L'autenticazione utilizza una singola chiave API passata nell'intestazione. L'URL di base è HTTPS://api.unzensierte.cc/v1. Questo URL funziona con gli SDK ufficiali di OpenAI impostando il parametro base_url. La tua chiave identifica il tuo account e traccia l'utilizzo dei token. Genera una chiave nella pagina Ottieni chiave API. Appare immediatamente dopo la registrazione tramite Google o email. Usa questa chiave in ogni richiesta. Le chiavi non valide restituiscono un errore 401. Scadenza o credito insufficiente restituiscono 402.

Mantieni la chiave al sicuro. Una chiave attiva per account. Una nuova chiave sostituisce quella precedente. Non è richiesto il numero di telefono per la registrazione. La chiave API è l'unica credenziale necessaria per l'accesso.

Endpoint Chat Completions

L'endpoint principale è POST /v1/chat/completions. Accetta payload JSON con modello, messaggi e parametri. L'ID del modello è "uncensored". I messaggi richiedono un ruolo e una stringa di contenuto. Il sistema risponde con il testo generato nell'array choices. È possibile impostare temperatura, top_p e sequenze di stop. Questi parametri controllano la creatività e la lunghezza dell'output. L'API restituisce l'utilizzo dei token nella risposta. Gli errori includono un messaggio e un tipo. Utilizza questo endpoint per tutte le attività di generazione di testo. È l'unico endpoint di testo disponibile. Qui non ci sono embedding o generazione di immagini.

Risposte in streaming e utilizzo

Abilita lo streaming impostando stream su true. L'API invia Server-Sent Events (SSE). Ogni chunk contiene testo parziale. L'ultimo chunk include i dati di utilizzo dei token. Ciò consente la visualizzazione in tempo reale del testo generato. Memorizza gli chunk nella tua applicazione. Combinale per formare la risposta completa. Lo streaming riduce la latenza percepita per output lunghi. Usalo per interfacce chat o per l'elaborazione di dati in diretta. L'oggetto usage appare solo nell'ultimo chunk. Traccia i token di input e output per il fatturazione. Gli errori durante lo streaming restituiscono comunque l'oggetto error in un chunk.

Function calling e modalità JSON

Utilizza il function calling per integrare strumenti esterni. Definisce gli strumenti nel corpo della richiesta. Il modello restituisce chiamate agli strumenti con argomenti. Analizza questi argomenti per eseguire le tue funzioni. Imposta tool_choice su auto o nomi di funzioni specifici. La modalità JSON forza l'output in JSON valido. Imposta response_format su json_object. Questo garantisce dati strutturati per il parsing. Usa queste funzionalità per flussi di lavoro automatizzati. Combinale per comportamenti di agenti complessi. Il modello supporta i formati standard degli strumenti OpenAI. Verifica che le tue definizioni degli strumenti corrispondano allo schema atteso.

Limiti e gestione degli errori

I limiti di frequenza sono di 300 richieste al minuto per chiave. La concorrenza è limitata a 8 richieste simultanee. I corpi delle richieste devono essere inferiori a 8 MB. Gli errori includono codici specifici come 401 per chiavi non valide. 402 indica credito prepagato insufficiente. 429 segnala il superamento del limite di frequenza. La finestra di contesto è di 100,000 token in totale. L'output massimo è di 16,000 token per richiesta. Gli errori restituiscono JSON con i dettagli dell'errore. Gestisci i retry per gli errori 429. Controlla il saldo del credito prima di un utilizzo intenso. I rimborsi non sono disponibili per il credito speso.

cURL

Copycurl https://api.unzensierte.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List 5 common Linux commands for file management"}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

Streaming

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)