Documentazione API

URL Base e Autenticazione

Invia richieste a https://api.uncensoredaicharacter.com/v1 con la tua chiave API nel Authorization header. La chiave viene emessa immediatamente alla registrazione tramite Google o email. Usa l'ID del modello uncensored per tutte le completazioni.

Copycurl https://api.uncensoredaicharacter.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the current server uptime status"}]
  }'

Ogni account contiene una chiave attiva. Se ruoti la chiave, quella vecchia smette di funzionare istantaneamente. Si applicano limiti per chiave per mantenere il servizio equo. I corpi delle richieste devono rimanere sotto gli 8 MB. Questo garantisce prestazioni coerenti per la tua applicazione.

Prima richiesta: SDK Python

Inizializza il client con la tua chiave e puntalo al nostro URL base. Passa il nome del modello e i messaggi utente per ottenere una risposta testuale. Questo funziona con le librerie standard compatibili con OpenAI. La risposta include l'utilizzo dei token e il contenuto.

Copyfrom openai import OpenAI

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

Puoi regolare parametri come temperature per controllare la casualità. L'API restituisce JSON o testo in base alle tue impostazioni. Gli errori restituiscono codici di stato HTTP standard. Controlla il codice di stato per gestire i problemi in modo elegante.

Prima richiesta: SDK Node

Configura il client Node per utilizzare il nostro endpoint. Imposta il apiKey e baseURL proprietà correttamente. Chiama chat.completions.create() con l'ID del modello. La libreria gestisce automaticamente la serializzazione e i tentativi di ripetizione.

Copyimport OpenAI from "openai";

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

Le risposte in stream sono supportate tramite iteratori asincroni. Questo ti permette di visualizzare i token man mano che vengono generati. La finestra di contesto supporta fino a 100,000 token in totale. Usa questo per documenti lunghi o conversazioni estese.

Risposte in streaming

Abilita lo streaming impostando stream: true nella tua richiesta. L'API restituisce uno stream di Server-Sent Events (SSE). Ogni chunk contiene testo parziale e dati sull'utilizzo dei token. L'ultimo chunk include le statistiche complete sull'utilizzo.

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)

Lo streaming riduce la latenza percepita per gli utenti finali. Puoi elaborare i token in tempo reale senza aspettare la risposta completa. Il buffering è gestito dalla libreria client. Monitora i conteggi dei token per rimanere entro il tuo credito prepagato.

Gestazione degli errori e limiti

Gestisci gli errori controllando il codice di stato HTTP. Un 401 errore significa che la tua chiave API non è valida o è mancante. Un 402 errore indica credito prepagato insufficiente. Un 429 errore segnala che hai raggiunto il limite di frequenza di 300 richieste al minuto. I rimborsi non sono disponibili per il credito utilizzato.

La finestra di contesto consente 100,000 token per input e output combinati. L'output massimo è di 16,000 token per richiesta. Imposta max_tokens per controllare la lunghezza dell'output. Gli errori non consumano credito se rilevati prima dell'elaborazione. Questo protegge il tuo saldo da loop accidentali.

Configurazione e vincoli

Imposta parametri come top_p, seed, e stop sequenze per modellare l'output. Usa response_format per la modalità JSON. Il function calling è supportato tramite tools. Tutti i parametri seguono lo schema standard OpenAI. Questo rende la migrazione facile per i progetti esistenti.

Le richieste sono limitate a 8 connessioni concorrenti per chiave. Il limite della dimensione del corpo è di 8 MB. Questi vincoli garantiscono prestazioni stabili. Il modello uncensored gestisce argomenti diversificati senza rifiuti. Regola le impostazioni per adattarle perfettamente al tuo caso d'uso.