Documentazione API per sviluppatori

URL Base e Autenticazione

Connettiti alla nostra infrastruttura puntando il client all'URL di base designato e fornendo la tua chiave API univoca. Utilizziamo l'autenticazione standard tramite intestazione in modo che tu possa inserire il nostro endpoint nelle configurazioni SDK OpenAI esistenti senza riscrivere la logica principale. Ricevi una chiave attiva per account e la generazione di una nuova chiave invalida immediatamente quella precedente. Questo design mantiene la tua integrazione semplice garantendo un chiaro controllo degli accessi. Iscriviti tramite Google o email per vedere la tua chiave istantaneamente. Non richiediamo un numero di telefono o un metodo di pagamento per iniziare.

• Base URL: https://api.uncensoreai.com/v1
• Intestazione Auth: Authorization: Bearer YOUR_API_KEY

Prima richiesta (POST /v1/chat/completions)

Invia la tua prima completion inviando un payload JSON all'endpoint delle chat completions. L'ID del modello è uncensored e accetta strutture di messaggi standard con ruoli system, user e assistant. Ottieni un output testuale immediato senza routing complesso o logica di selezione del modello. Gli errori non consumano i tuoi crediti prepagati, quindi puoi testare liberamente. Il modello gestisce la generazione open-weight ottimizzata per i contenuti per adulti senza rifiuti. Usa questa struttura per iniziare la tua integrazione.

Integrazione SDK Python

Utilizza il client Python ufficiale per interagire in modo trasparente con la nostra API. Imposta l'URL di base e la chiave API nel tuo oggetto di configurazione prima di effettuare le chiamate. La libreria gestisce la serializzazione JSON e l'analisi delle risposte per te. Puoi accedere ai dati di utilizzo direttamente dall'oggetto di risposta. Questo approccio funziona con qualsiasi ambiente Python standard che supporta richieste async o sync. Mantieni la tua chiave sicura nelle variabili di ambiente. Il campione di codice dimostra una chiamata sincrona di base.

Integrazione SDK Node.js

Integra con progetti Node.js utilizzando il gestore di pacchetti standard. Importa il client e configura l'URL di base per puntare ai nostri server. L'SDK gestisce le richieste HTTP e fornisce risposte tipizzate per gli utenti TypeScript. Puoi aggiungere facilmente intestazioni o modificare i timeout se necessario. Questo metodo si adatta alle moderne applicazioni web e ai servizi backend. Assicurati che la tua versione di Node sia compatibile con i requisiti dell'SDK. L'esempio seguente mostra una semplice richiesta di completamento.

Risposte in streaming e utilizzo dei token

Abilita l'output in tempo reale impostando il stream flag su true nella tua richiesta. L'API restituisce Server-Sent Events (SSE) man mano che i token vengono generati. Puoi visualizzare il testo agli utenti istantaneamente senza attendere la risposta completa. I dettagli sull'utilizzo dei token appaiono nell'ultimo chunk dello stream. Questa funzione riduce la latenza percepita per output lunghi. Monitora il tuo saldo di credito man mano che i token si accumulano. Lo streaming funziona con tutti i parametri standard come temperature e sequenze di stop.

Limiti, Errori e Finestra di Contesto

Il tuo account ha una finestra di contesto di 100.000 token per prompt e completamento combinati. Puoi inviare fino a 16.000 token in una singola risposta se specifichi max_tokens. Il limite di output predefinito è di 2,048 token se si omette questo parametro. I limiti di frequenza consentono 300 richieste al minuto e 8 richieste concorrenti per chiave. Uno status 401 indica che la tua chiave non è valida. Uno status 402 indica credito prepagato insufficiente. Uno status 429 indica che hai superato il limite di frequenza. I corpi delle richieste non possono superare gli 8 MB.

cURL

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

Python

Copyfrom openai import OpenAI

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