Documentazione API Uncutly AI

Prima richiesta

Invia il tuo primo messaggio al /v1/chat/completions endpoint utilizzando il tuo client HTTP preferito.

L'identificatore del modello è semplicemente uncensored. Questo modello open-weight è eseguito sui nostri server e risponde senza i tipici rifiuti di contenuti per uso adulto lecito.

Puoi inviare strutture di prompt standard. L'API accetta input testuale e restituisce output testuale. È compatibile con qualsiasi SDK o client OpenAI che supporta il formato chat-completions.

Ecco un esempio base in cURL per ottenere una risposta.

Copycurl https://api.uncutlyai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Show me the API endpoint for text generation"}]
  }'

SDK Python

Usa il pacchetto Python ufficiale di OpenAI per interagire con la nostra API con codice minimo.

Imposta il base_url e api_key parametri nell'inizializzazione del client. Questo garantisce che le richieste vengano instradate al nostro endpoint uncensored invece che ai server di OpenAI.

Il nome del modello è uncensored. Puoi passare i messaggi come una lista di dizionari. L'oggetto di risposta contiene il testo generato in response.choices[0].message.content.

Questo approccio funziona per script semplici o logica applicativa complessa. Gestisce la serializzazione automaticamente.

Copyfrom openai import OpenAI

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

SDK Node

Integra l'API nelle tue applicazioni Node.js utilizzando il openai pacchetto.

Configura il client con il nostro URL di base e la tua chiave API. L'SDK gestisce le richieste HTTP e analizza la risposta JSON.

Chiama il chat.completions.create metodo con il modello uncensored. Puoi definire prompt di sistema o messaggi utente come necessario.

Questo metodo è affidabile per la generazione lato server. Si integra bene nelle route di Express o nei job in background.

Copyimport OpenAI from "openai";

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

Risposte in streaming

Ricevi testo token per token utilizzando Server-Sent Events (SSE) per una latenza percepita inferiore.

Imposta il stream il parametro a true nella tua richiesta. L'API restituisce uno stream di chunk invece di una singola risposta completa.

Ogni chunk contiene testo parziale. Puoi concatenare questi chunk per costruire il messaggio finale. Questo è utile per le interfacce chat che si aggiornano in tempo reale.

L'ultimo chunk include le statistiche di utilizzo. Puoi tracciare direttamente dal flusso il consumo di token.

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)

Limiti, Errori & Contesto

Comprendere i vincoli e i codici di errore per risolvere rapidamente i problemi di integrazione.

La tua finestra di contesto è di 100.000 token in totale. Questo include sia il prompt di input che l'output generato. Puoi impostare un output massimo di 16.000 token per richiesta.

I limiti di velocità sono impostati a 300 richieste al minuto per chiave. Puoi eseguire 8 richieste concorrenti simultaneamente. Il limite del corpo della richiesta è di 8 MB.

Gli errori comuni includono 401 per una chiave non valida e 402 quando esaurisci il credito prepagato. Un errore 429 significa che hai raggiunto il limite di frequenza. Gli errori non consumano il tuo saldo di credito.

I prezzi sono trasparenti: $0.15 per 1M di token in input e $0.50 per 1M di token in output. Il credito è prepagato e non scade mai.