Documentazione API compatibile con OpenAI

URL Base e Autenticazione

Invia richieste al nostro endpoint dedicato utilizzando gli header standard. Ospitiamo un modello uncensored sui nostri server, quindi non è necessario instradare il traffico tramite proxy di terze parti o gestire selezioni di modelli complesse.

Utilizza l'URL base HTTPS://api.grokaiuncensored.com/v1 e includi la tua chiave API nell'header Authorization. Ottieni una chiave attiva per account, che ricevi immediatamente dopo l'iscrizione con Google o email. Devi semplicemente aggiornare le variabili base_url e API key nella tua configurazione.

Endpoint Chat Completions

Invia prompt di testo e ricevi completamenti utilizzando l'endpoint standard chat-completions. Questa è un'API solo testo senza funzionalità di embedding, generazione di immagini o elaborazione audio.

Invia una richiesta POST a /v1/chat/completions con il tuo array messages. L'identificatore del modello è "uncensored". Questo modello è ottimizzato per rispondere senza rifiuti di contenuto per l'uso adulto lecito, anche se blocca sempre i contenuti sessuali che coinvolgono minori.

Puoi inviare fino a 8 MB per il corpo della richiesta. La finestra di contesto consente 100,000 token per il prompt e il completamento combinati. Se non specifichi max_tokens, il limite di output predefinito è di 2,048 token.

Copycurl https://api.grokaiuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the capital of France?"}]
  }'

Integrazione SDK Python

Utilizza la libreria Python ufficiale di OpenAI per interagire con la nostra API LLM senza filtri. Questo approccio richiede modifiche minime al codice se sei già familiare con le integrazioni standard di OpenAI.

Inizializza il client con il nostro URL base e la tua chiave API. La libreria gestisce automaticamente la formattazione delle richieste e l'analisi delle risposte. Puoi impostare parametri come temperature e top_p per controllare la casualità dell'output.

La gestione degli errori funziona esattamente come previsto. Se esaurisci i crediti prepagati, l'API restituisce un errore 402. Se la tua chiave non è valida, ricevi un errore 401. Questi errori sono distinti dai limiti di velocità, che restituiscono un codice di stato 429.

Copyfrom openai import OpenAI

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

Integrazione SDK Node

Integra l'API AI uncensored nelle tue applicazioni Node.js utilizzando l'SDK standard. Questo garantisce la compatibilità con i flussi di lavoro e le librerie Node esistenti.

Configura il client con l'URL di base e la tua chiave API. L'SDK gestisce le richieste HTTP e analizza le risposte JSON in modo efficiente. Puoi passare i messaggi direttamente al metodo chat.completions.create.

L'SDK supporta le risposte in streaming, utili per output lunghi. Puoi anche utilizzare il function calling e la modalità JSON per la generazione di dati strutturati. La libreria gestisce in modo affidabile la segnalazione dell'utilizzo dei token e gli stati di errore.

Copyimport OpenAI from "openai";

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

Abilita lo streaming impostando stream su true nella tua richiesta. Questo restituisce Server-Sent Events (SSE) invece di un singolo oggetto JSON. Ricevi chunk di testo man mano che vengono generati, il che riduce la latenza percepita per gli utenti.

Ogni chunk contiene contenuto parziale. L'ultimo chunk include le statistiche sull'utilizzo dei token per l'intera richiesta. Questo ti permette di monitorare con precisione i token di input e output senza attendere il completamento completo.

Lo streaming è ideale per le interfacce di chat e le applicazioni in tempo reale. Il modello non filtrato supporta questa funzionalità senza alcuna configurazione aggiuntiva. Puoi combinare lo streaming con il function calling per interazioni dinamiche.

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 e Contesto

Monitora i tuoi limiti di richiesta e i codici di errore per mantenere un funzionamento fluido. Hai diritto a 300 richieste al minuto per chiave e fino a 8 richieste concorrenti. La finestra di contesto supporta 100.000 token in totale.

L'errore 401 indica una chiave API non valida o scaduta. L'errore 402 significa che il credito prepagato è esaurito; ricarica con USDT o USDC per continuare. L'errore 429 indica che hai raggiunto il limite di velocità; attendi qualche secondo e riprova.

Errori e rifiuti sono gratuiti, quindi paghi solo per la generazione di token riuscita. Il tuo credito prepagato non scade mai, quindi puoi ricaricare quando necessario.