Riferimento API GitHub Uncensored AI

Autenticazione & URL di Base

L'API richiede un token bearer per ogni richiesta. Generi questa chiave istantaneamente tramite il dashboard usando credenziali Google o email. Una volta creata, la chiave autentica il tuo account prepagato contro il modello ospitato.

Imposta il tuo URL base per puntare direttamente al nostro gateway API. Questo garantisce che tutte le richieste vengano instradate al server del modello uncensored corretto.

Usa l'intestazione Authorization standard con lo schema Bearer. Sostituisci il segnaposto con la tua stringa di chiave univoca.

Configurazione Base

• Base URL: https://api.githubuncensoredai.com/v1
• Intestazione Auth: Authorization: Bearer YOUR_API_KEY
• ID modello: uncensored

Copycurl https://api.githubuncensoredai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix the syntax error in this python loop"}]
  }'

Endpoint Chat Completions

Invia dati di testo all'endpoint chat completions e ricevi testo generato in risposta. Il sistema accetta un elenco di messaggi con ruoli come user o assistant. Restituisce un completamento basato sulla cronologia dei prompt.

Questo endpoint gestisce flussi di conversazione standard. Puoi inviare più turni e il modello mantiene il contesto fino al limite. Non supporta input di immagini, audio o video. Il formato della risposta è JSON standard.

Assicurati che il tuo payload includa l'identificatore del modello. Il sistema ignora i campi sconosciuti in modo elegante. Gli errori restituiscono codici specifici se l'autenticazione fallisce o i crediti si esauriscono.

Copyfrom openai import OpenAI

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

Risposte in streaming

Abilita lo streaming impostando il flag stream su true. L'API restituisce una serie di Server-Sent Events invece di un singolo oggetto JSON. Ogni evento contiene un chunk del testo generato.

Questo approccio riduce la latenza percepita per le risposte lunghe. Puoi iniziare a visualizzare il testo agli utenti man mano che viene generato. L'ultimo chunk include le statistiche di utilizzo dei token per il fatturazione.

Gestisci in modo efficiente lo stream nel codice client. Chiudi la connessione quando lo stream termina o si verifica un errore. Questo metodo funziona bene per le interfacce di chat in tempo reale.

Copyimport OpenAI from "openai";

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

Function Calling & JSON Mode

Il modello supporta l'output strutturato tramite function calling. Definisci gli strumenti nella tua richiesta con nomi, descrizioni e schemi di parametri. Il modello seleziona lo strumento appropriato e genera gli argomenti.

Usa la modalità JSON per una rigorosa conformità allo schema. Imposta il formato di risposta su json_object per forzare l'output JSON valido. Questo è utile per l'analisi dei dati o la generazione di frammenti di codice.

Combina il function calling con lo streaming per esperienze interattive. Il modello può invocare più strumenti in sequenza. Convalida lo schema dell'output prima di eseguire le funzioni nella logica della tua applicazione.

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)

Parametri & Limiti

Controlla il comportamento di generazione con parametri come temperature e top_p. Regola questi valori per bilanciare creatività e determinismo. Le impostazioni predefinite funzionano per la maggior parte degli scopi generali.

Rispetta i limiti di richiesta per evitare errori. Puoi inviare fino a 300 richieste al minuto per chiave. Le richieste concorrenti sono limitate a otto per chiave. La dimensione massima del corpo della richiesta è di 8 MB.

La finestra di contesto è di 100.000 token. Questo include i token del prompt e del completamento. L'output è limitato a 16.000 token per richiesta. Il superamento di questi limiti restituisce un codice di errore.

Utilizzo dei Token e Fatturazione

La fatturazione è prepagata e basata sull'utilizzo effettivo dei token. I token di input costano $0.15 per milione e i token di output costano $0.50 per milione. Errori e rifiuti non consumano crediti.

Il credito non scade mai. Le ricariche vengono elaborate esclusivamente tramite criptovaluta. Ricevi crediti bonus per depositi più consistenti. Il sistema traccia accuratamente l'utilizzo per ogni chiave API.

Monitora il tuo saldo tramite la dashboard. Se i crediti si esauriscono, le tue richieste falliranno con un codice di errore specifico. Aggiungi fondi istantaneamente per riprendere il servizio senza attendere approvazioni.