Guida rapida per utenti di Unhinged Grok

Autenticazione e URL di base

La nostra API è compatibile con OpenAI, il che significa che non hai bisogno di una nuova libreria. Devi solo aggiornare due valori nella tua configurazione esistente: base_url e api_key. La tua chiave API viene generata immediatamente al momento della registrazione tramite Google o email. Mantieni questa chiave al sicuro; è l'unica credenziale richiesta per l'autenticazione.

Sostituisci l'URL base standard di OpenAI con il nostro endpoint. Questa modifica indirizza tutte le richieste successive ai server del nostro modello senza censura. Non sono necessarie altre modifiche al codice per la generazione di testo di base.

Esempio di configurazione

• URL base: https://api.unhingedgrok.com/v1
• Chiave API: La tua chiave univoca dal dashboard

Verifica la tua connessione elencando i modelli disponibili. Questo conferma che l'autenticazione funziona correttamente prima di inviare richieste di generazione.

Prima richiesta

Inizia inviando una semplice richiesta di completamento del testo. Questo esempio utilizza curl per dimostrare la struttura HTTP grezza. La richiesta punta all'endpoint /v1/chat/completions con l'ID del modello uncensored. La risposta restituisce il testo generato nell'array choices.

Questo approccio diretto funziona per qualsiasi linguaggio o strumento che supporti i formati HTTP standard di OpenAI. Puoi testarlo immediatamente dopo aver generato la tua chiave.

Richiesta HTTP diretta

Copiacurl https://api.unhingedgrok.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Integrazione SDK Python

Utilizza la libreria ufficiale Python di OpenAI per integrare la nostra API. Installa il pacchetto tramite pip. Inizializza il client con la tua chiave e l'URL base personalizzato. Il resto dei metodi SDK, come chat.completions.create, funziona esattamente come documentato per OpenAI.

Questo metodo è ideale per servizi backend, script di elaborazione dati o flussi di lavoro automatizzati. L'SDK gestisce automaticamente la serializzazione JSON e l'analisi delle risposte.

Esempio di codice Python

Copiafrom openai import OpenAI

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

Per ambienti JavaScript o TypeScript, utilizza il pacchetto npm ufficiale openai. Configura il client con lo stesso URL base e chiave. L'SDK Node supporta sia pattern basati su callback che su promesse.

Questa configurazione ti consente di integrare la generazione di testo senza censura direttamente in applicazioni web, funzioni serverless o strumenti di automazione basati su Node. La gestione degli errori rimane coerente con il comportamento standard degli SDK OpenAI.

Esempio di codice Node.js

Copiaimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.unhingedgrok.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 la generazione di token in tempo reale impostando stream: true. L'API restituisce uno stream di Server-Sent Events (SSE). Ogni chunk contiene una risposta parziale. L'ultimo chunk include le statistiche sull'utilizzo dei token.

Lo streaming riduce la latenza percepita per gli utenti finali. È essenziale per interfacce chat e applicazioni interattive. Gestisci ogni chunk incrementalmente per aggiornare l'UI immediatamente.

Esempio di codice streaming

Copiastream = 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

Comprendi i vincoli operativi per evitare interruzioni del servizio. La finestra di contesto supporta 100,000 token in totale e, se max_tokens non è impostato, la risposta può estendersi fino alla fine della finestra.

I limiti di richieste permettono 300 richieste al minuto per chiave. Le richieste parallele sono limitate a 8. I corpi delle richieste non devono superare 8 MB. Gestisci i codici di errore HTTP standard: 401 indica una chiave non valida, 402 segnala credito insufficiente e 429 indica il superamento del limite. Gli errori non consumano credito.