it ▾
Ottieni la tua chiave
chatunrestricted.com

Documentazione API

Connetti la tua app Python o Node.js a un LLM uncensored in meno di un minuto. Utilizza gli endpoint standard compatibili con OpenAI per generare testo senza rifiuti di contenuto.

Avvio rapido: Prima richiesta con Python o JS

Invia il tuo primo prompt e ottieni immediatamente un output testuale grezzo. L'API accetta payload standard per le chat-completion, quindi puoi sostituire il nostro URL base e la chiave per iniziare a generare contenuti uncensored senza riscrivere la tua logica. Usa il seguente comando cURL per verificare la connettività e la disponibilità del modello prima di integrarlo nel tuo codice.

Questa richiesta iniziale conferma che l'endpoint è raggiungibile e che il tuo token di autenticazione è valido. Puoi quindi procedere a costruire la logica della tua applicazione utilizzando i wrapper SDK forniti.

curl https://api.chatunrestricted.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the three main endpoints for user authentication"}]
  }'

Autenticazione & URL di Base

Autenticati passando la tua chiave API nell'intestazione HTTP. Tutte le richieste devono puntare all'URL di base https://api.chatunrestricted.com/v1 per garantire la compatibilità con gli SDK OpenAI. Puoi generare la tua chiave istantaneamente tramite la dashboard utilizzando credenziali Google o email, senza bisogno di un numero di telefono.

La chiave API identifica il tuo account e traccia l'utilizzo dei token rispetto al tuo saldo prepagato. Mantieni questa chiave sicura, poiché fornisce accesso diretto al tuo credito. È consentita una sola chiave attiva per account; la generazione di una nuova chiave invalida automaticamente quella precedente.

POST /v1/chat/completions

Genera testo inviando una richiesta POST all'endpoint di completamento della chat. L'ID del modello è uncensored, che esegue un modello open-weight ottimizzato per rispondere senza rifiuti di contenuto per uso adulto legale. Puoi controllare la lunghezza dell'output, la casualità e le condizioni di arresto tramite parametri standard.

Questo endpoint supporta le risposte in streaming, il function calling e la modalità JSON. Non supporta embedding, immagini o fine-tuning. Utilizza l'SDK Python per gestire la richiesta in modo asincrono per ottenere prestazioni migliori nelle applicazioni web.

from openai import OpenAI

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

GET /v1/models

Recupera l'elenco dei modelli disponibili per confermare la struttura dell'API. La risposta include il uncensored ID del modello, che devi specificare nelle tue richieste di completamento. Questo endpoint ti aiuta a verificare che il servizio sia online e che l'ID del modello non sia cambiato.

Usa questo endpoint per risolvere i problemi di connettività prima di inviare richieste di generazione costose. Restituisce i metadati del modello compatibili con OpenAI standard, inclusi l'ID del modello e il tipo di oggetto.

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.chatunrestricted.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: Temperatura, Top P, Seed

Controlla la casualità e la determinismo dei tuoi output utilizzando parametri di campionamento standard. Imposta temperature tra 0 e 2 per regolare la creatività, e usa top_p per limitare il campionamento del nucleo. Il seed parameter ti permette di riprodurre output specifici per il debug o scenari di roleplay coerenti.

Questi parametri influenzano direttamente il modo in cui il modello genera il testo. Temperature più elevate producono risposte più diversificate, mentre temperature più basse rendono l'output più focalizzato e prevedibile. Usa stop sequenze per interrompere la generazione a marcatori specifici.

Streaming, Tools e Modalità JSON

Trasmetti le risposte in tempo reale utilizzando Server-Sent Events (SSE) per una latenza inferiore. Abilita la modalità JSON impostando response_format a json_object per l'estrazione di dati strutturati. Il function calling è supportato per l'esecuzione di funzioni, consentendo al modello di invocare API esterne.

Lo streaming è essenziale per creare interfacce di chat che visualizzano i token man mano che vengono generati. L'ultimo blocco di uno stream contiene l'utilizzo totale dei token per la richiesta, consentendo un monitoraggio accurato della fatturazione. Usa l'esempio seguente per implementare lo streaming nella tua applicazione.

stream = 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)

Limiti di frequenza e fatturazione

Monitora i limiti di frequenza per evitare interruzioni del servizio durante un utilizzo ad alto volume. L'API applica un limite di 300 richieste al minuto e un limite di concorrenza di 8 richieste simultanee per chiave. La dimensione massima del corpo della richiesta è di 8 MB.

La fatturazione è prepagata e basata sull'utilizzo reale dei token. Errori e rifiuti non consumano credito. Se riscontri un errore 401, la tua chiave API non è valida. Un errore 402 indica credito insufficiente, mentre un errore 429 significa che hai superato il limite di frequenza. La finestra di contesto supporta 100.000 token per prompt e completamento combinati.

Domande frequenti

Come gestisco gli errori API nella mia applicazione?

Verifica il codice di stato HTTP per determinare il problema. Un errore 401 significa che la tua chiave API non è valida o manca. Un errore 402 indica che il tuo credito prepagato è stato esaurito. Un errore 429 indica che hai superato il limite di frequenza di 300 richieste al minuto.

Qual è il limite della finestra di contesto?

La finestra di contesto supporta 100.000 token per il prompt e il completamento combinati. Il massimo output per richiesta è di 16.000 token, o 2.048 token se il parametro max_tokens non è impostato esplicitamente.

L'API supporta le risposte in streaming?

Sì, l'API supporta lo streaming tramite Server-Sent Events (SSE). Ogni chunk contiene testo parziale e l'ultimo chunk include l'utilizzo totale dei token per la richiesta. Questo consente la visualizzazione in tempo reale del testo generato nella tua applicazione.

Genera la tua chiave API

Registrati, copia la tua chiave e aggiorna il tuo URL di base. È tutto ciò che devi fare.