Documentazione API

URL Base e Autenticazione

L'endpoint della nostra API è HTTPS://api.aichatuncensored.cc/v1. Autentica ogni richiesta inserendo la tua chiave API univoca nell'intestazione Authorization: Bearer <key> header. Ricevi questa chiave immediatamente dopo esserti registrato con Google o email nella pagina Ottieni chiave API. Non è richiesto il numero di telefono e la chiave viene mostrata una sola volta per sicurezza.

Copycurl https://api.aichatuncensored.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Show me the current UTC timestamp"}]
  }'

Questo URL di base funziona con gli SDK ufficiali di OpenAI e qualsiasi client compatibile. Configurare semplicemente la libreria per puntare al nostro indirizzo. È possibile generare una nuova chiave in qualsiasi momento, che sostituisce quella precedente. Ogni account è limitato a una chiave attiva.

Prima richiesta con cURL

Invia il tuo primo prompt utilizzando un standard POST richiesta a /v1/chat/completions. L'identificatore del modello è uncensored, che serve un singolo modello open-weight ottimizzato per contenuti senza restrizioni. Il testo di input va nell' messages array. La risposta restituisce il testo generato nel content campo.

Copycurl https://api.aichatuncensored.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Show me the current UTC timestamp"}]
  }'

Errori come credito insufficiente restituiscono uno status 402. I rifiuti per contenuti minori sono rari ma possibili. Lo streaming è disponibile tramite Server-Sent Events per la consegna dei token in tempo reale. Ogni richiesta supporta fino a 8 MB di dati nel body.

Integrazione SDK Python

Utilizza la libreria Python ufficiale per interagire con la nostra API. Imposta l'URL di base e la chiave API nella configurazione del client. Questo ti permette di sfruttare metodi familiari come chat.completions.create. La sintassi rispecchia le implementazioni standard di OpenAI.

Copyfrom openai import OpenAI

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

Installa il pacchetto e inizializza il client con le tue credenziali. Passa il nome del modello uncensored per garantire che tu raggiunga il nostro endpoint senza restrizioni. Puoi regolare parametri come temperature o top_p per controllare la creatività. L'oggetto risposta contiene statistiche di utilizzo nell'ultimo chunk se in streaming.

Setup SDK Node.js

Inizializza il client Node.js con il tuo URL di base e la chiave. Questo abilita chiamate dirette all'endpoint delle chat completions. La libreria gestisce la serializzazione JSON e l'iniezione delle intestazioni automaticamente.

Copyimport OpenAI from "openai";

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

Chiama il metodo completion con i tuoi messaggi di prompt. La risposta include il testo generato e i conteggi dei token. Puoi eseguire lo streaming dei risultati impostando il flag stream su true. La gestione degli errori è integrata nell'SDK. Controlla il codice di stato per le risposte 401 o 429 per gestire i limiti.

Risposte in streaming (SSE)

Abilita lo streaming impostando stream: true nella tua richiesta. Il server invia chunk di dati come Server-Sent Events. Ogni chunk contiene testo parziale e metadati di utilizzo. Questo riduce la latenza percepita per gli output lunghi.

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)

Analizza il flusso SSE per accumulare la risposta finale. L'ultimo chunk include l'utilizzo totale dei token. Puoi interrompere lo streaming in anticipo se necessario. Il function calling e la modalità JSON supportano anche lo streaming. Questa funzionalità è ideale per le interfacce di chat in tempo reale.

Limiti di frequenza e gestione degli errori

Hai un limite di 300 richieste al minuto per chiave. Le richieste concorrenti sono limitate a 8 per chiave. Se superi questi limiti, ricevi un codice di stato 429. I fallimenti di autenticazione restituiscono un errore 401. Il credito insufficiente attiva un errore 402.

La finestra di contesto supporta 100.000 token in totale. L'output massimo è di 16.000 token per richiesta. Imposta max_tokens per evitare costi imprevisti. Errori e rifiuti non consumano credito. Usate la retroesponenziale per i retry dei limiti di frequenza.