Documentazione API

Autenticazione e Base URL

L'API richiede una singola chiave API per l'autenticazione. Ricevi questa chiave immediatamente dopo esserti registrato con Google o un indirizzo email. Passala nel Authorization header come token Bearer. L'URL di base è https://api.topuncensored.com/v1. Questo URL funziona con qualsiasi SDK o libreria client compatibile con OpenAI.

• Usa l'intestazione: Authorization: Bearer YOUR_API_KEY
• Imposta il base URL del tuo client sull'endpoint fornito.

Questa configurazione garantisce che tu possa sostituire le librerie senza modificare la logica principale.

Copycurl https://api.topuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a list of ten distinct UI layout patterns."}]
  }'

Endpoint Chat Completions

Invia prompt di testo al /v1/chat/completions endpoint. endpoint. L'ID del modello è uncensored. Questo endpoint gestisce la formattazione standard della chat con messaggi. Restituisce risposte testuali direttamente. Non ci sono strati o wrapper extra. Controlli la finestra di contesto di 100.000 token. Le richieste inferiori a 8 MB funzionano in modo affidabile. Usa questo per la generazione diretta di testo.

Struttura la tua richiesta con un prompt system e un messaggio user. Il modello risponde senza filtrare i contenuti adulti leciti. Errori come chiavi mancanti restituiscono 401. Finisci i crediti? Ricevi un errore 402. Questi sono segnali chiari.

Risposte in streaming

Abilita lo streaming impostando stream: true. Ricevi chunk di testo mentre vengono generati. Questo riduce la latenza percepita per output lunghi. L'ultimo chunk include i dati di utilizzo dei token. Usali per visualizzazioni in tempo reale o rendering progressivo. È efficiente per applicazioni ad alto volume.

Analizza ogni frammento per costruire la tua risposta finale. Questo metodo gestisce gli output grandi con grazia. L'API supporta gli eventi inviati dal server standard. Questo è l'approccio consigliato per le app interattive.

Copyfrom openai import OpenAI

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

Chiamata di strumenti e modalità JSON

Utilizza il function calling per interazioni strutturate. Definisce gli strumenti nella tua richiesta. Il modello restituisce argomenti strutturati. Imposta response_format a {"type": "json_object"} per l'output JSON rigoroso. Questo garantisce formati di output prevedibili. Combina queste funzionalità per integrazioni robuste. Ottieni un controllo preciso sulla struttura dell'output.

La chiamata di strumenti funziona con lo schema standard OpenAI. La modalità JSON forza un JSON valido. Usa queste funzionalità per integrazioni API o estrazione di dati. Questa flessibilità supporta flussi di lavoro complessi.

Copyimport OpenAI from "openai";

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

Parametri e limiti

Regola temperature, top_p, e stop sequenze. Imposta max_tokens a 16,000. Il valore predefinito è 2,048 se omesso. Controlla la ripetizione con presence_penalty e frequency_penalty. Usa seed per output deterministici. Questi parametri affinano la qualità della generazione. Hai il controllo totale sullo stile dell'output.

I limiti di frequenza sono di 300 richieste al minuto. Le richieste concorrenti sono limitate a 8. Questi limiti garantiscono prestazioni stabili. Monitora il tuo utilizzo tramite la dashboard. Regola i parametri per ottimizzarli per il tuo caso d'uso specifico.

Errori e finestra di contesto

Gestisci gli errori in modo elegante. 401 significa chiave non valida. 402 indica crediti insufficienti. 429 segnala i limiti di velocità. La finestra di contesto è di 100.000 token in totale. L'output massimo è di 16.000 token. Gestisci i tuoi token con saggezza. Gli errori non consumano credito. Questo fa risparmiare denaro durante il debug. Usa l'ultimo chunk per le statistiche di utilizzo.

Monitora l'utilizzo dei token. Evita di superare i limiti di frequenza. Riprova con un backoff esponenziale. Questo garantisce un funzionamento affidabile. L'API è progettata per la robustezza. Gestisci gli errori come parte del flusso normale.

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)