Documentazione API

Autenticazione e Base URL

L'API richiede un token bearer per ogni richiesta. Genera la tua chiave nella pagina Ottieni chiave API accedendo con Google o con password email. La chiave appare immediatamente senza verifica telefonica. Usa l'URL base https://api.uncensoredaigithub.com/v1 con gli SDK ufficiali OpenAI aggiornando il base_url e api_key valori. Questa configurazione funziona con qualsiasi client compatibile con OpenAI.

Endpoint: https://api.uncensoredaigithub.com/v1

Intestazione Auth: Authorization: Bearer YOUR_API_KEY

Ogni account supporta una chiave attiva. L'emissione di una nuova chiave invalida automaticamente quella precedente. Questo previene la deriva dei token quando ruoti le credenziali tra diversi ambienti.

Endpoint Chat Completions

Invia richieste di testo al /v1/chat/completions endpoint utilizzando l'ID del modello uncensored. L'API accetta messaggi di chat standard e restituisce risposte testuali senza filtri di contenuto per l'uso adulto lecito. Puoi configurare parametri come temperature, top_p, e stop per controllare la creatività e la lunghezza dell'output.

La finestra di contesto consente fino a 100.000 token per il prompt e il completamento combinati. Imposta max_tokens per controllare l'output, con un valore predefinito di 2.048 token se omesso. Errori e rifiuti non consumano credito, così puoi testare in sicurezza.

Risposte in streaming e utilizzo

Abilita lo streaming impostando stream: true nella tua richiesta. L'API restituisce Server-Sent Events (SSE) contenenti chunk di testo parziali. I dati sull'utilizzo dei token appaiono solo nell'ultimo chunk dello stream. Questo consente il rendering in tempo reale delle risposte mentre si monitora accuratamente il consumo.

Lo streaming è ideale per le applicazioni di roleplay o la generazione di contenuti a lungo termine. È possibile analizzare lo stream SSE per aggiornare l'interfaccia utente in modo incrementale. L'API garantisce che le metriche di utilizzo rimangano accurate anche se la connessione si interrompe prematuramente.

Function Calling e strumenti

Supporta la chiamata di funzioni fornendo un tools array nella richiesta. Il modello può restituire chiamate a funzione strutturate con argomenti. Usa tool_choice per imporre comportamenti specifici, come l'esecuzione automatica delle funzioni. Questa funzionalità abilita l'integrazione con servizi esterni o logica personalizzata.

Definisci le funzioni con nomi, descrizioni e schemi di parametri. L'API restituisce il nome della funzione e gli argomenti nella risposta. Analizza questi argomenti per eseguire il tuo codice personalizzato. Questa capacità rende l'API LLM uncensored adatta per flussi di lavoro di agent complessi.

Modalità JSON e parametri

Forza un output strutturato impostando response_format a {"type": "json_object"}. Il modello restituirà JSON invece di testo semplice. Questo è utile per l'estrazione di dati o la generazione di configurazioni. Combina questo con il function calling per integrazioni API robuste.

Altri parametri supportati includono seed per output deterministici, presence_penalty, e frequency_penalty. Usa seed per riprodurre risposte specifiche per il debug. Regola le penalità per ridurre le ripetizioni o incoraggiare un vocabolario diversificato nei tuoi output.

Gestazione degli errori e limiti

L'API impone un limite di 300 richieste al minuto e 8 richieste concorrenti per chiave. Il corpo della richiesta non deve superare gli 8 MB. Se superi questi limiti, ricevi un codice di stato 429. I fallimenti di autenticazione restituiscono un errore 401. Crediti insufficienti attivano un errore 402.

Il credito viene addebitato in base all'utilizzo reale dei token. Il credito prepagato non scade mai, quindi non devi preoccuparti dei rinnovi mensili. Utilizza la pagina Supporto per risolvere problemi come le addebitazioni doppie.

cURL

Copycurl https://api.uncensoredaigithub.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run the unit tests for the new auth module."}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

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)