Avvio rapido per gli utenti di Grok NSFW

Autenticazione e URL di base

La nostra API implementa il protocollo compatibile con openai. Ti autentichi inserendo la tua chiave API univaca nell'intestazione Authorization. L'URL di base per tutte le richieste è https://api.groknsfw.cc/v1. A differenza dei provider standard, non serve un ID organizzazione specifico. Genera semplicemente la tua chiave tramite la dashboard o la pagina di registrazione rapida. Tieni la chiave al sicuro: garantisce l'accesso completo al tuo credito prepagato. Non ci sono canoni mensili né abbonamenti, solo un prezzo a consumo per token senza scadenza.

Ogni richiesta deve includere l'identificatore del modello uncensored. Questo modello è un modello linguistico grande a pesi aperti ospitato sulla nostra infrastruttura, distinto da altri fornitori. È ottimizzato per fornire risposte senza restrizioni per contenuti adulti leciti mantenendo un'elevata accuratezza fattuale. Non è necessario modificare la versione della libreria client; gli SDK OpenAI standard funzionano subito.

Completamento chat di base

Invia una richiesta standard di completamento chat per generare testo. L'endpoint accetta un elenco di messaggi, inclusi ruoli system, user e assistant. Questa struttura ti permette di definire contesto, istruzioni e cronologia delle conversazioni. Il modello restituisce una risposta testuale basata sul prompt fornito. Puoi controllare la creatività dell'output utilizzando parametri come temperature e top_p. Se non è specificato max_tokens, il limite di output predefinito è di 2.048 token. Puoi aumentarlo fino a 32.000 token per richiesta, entro la finestra di contesto totale di 100.000 token.

Gli errori vengono restituiti in formato JSON standard. I problemi comuni includono chiavi non valide o credito insufficiente. L'API non gestisce la tokenizzazione per te; invii testo e il modello lo elabora internamente. Ricevi il testo generato finale o flussi parziali se abilitati.

Risposte in streaming

Chiamata di funzioni e strumenti

L'API supporta la chiamata di funzioni, consentendo al modello di produrre dati strutturati invece di testo normale. Definisci i tuoi strumenti nel parametro tools, specificando il nome della funzione, la descrizione e lo schema dei parametri. Quando il modello determina che è necessaria una chiamata a uno strumento, restituisce il nome della funzione e gli argomenti in formato JSON. La tua applicazione esegue quindi la funzione e inserisce il risultato nella conversazione. Questo abilita flussi di lavoro complessi, estrazione di dati e azioni automatizzate. Imposta tool_choice per controllare se il modello deve usare uno strumento o può scegliere liberamente.

Modalità JSON

Per le applicazioni che richiedono formati di output rigorosi, usa la modalità JSON. Imposta il parametro response_format su {"type": "json_object"}. Il modello limiterà il suo output a JSON valido. Questo è ideale per analizzare i dati nei tuoi sistemi backend o generare configurazioni strutturate. Nota che la modalità JSON può ridurre leggermente la flessibilità di ragionamento del modello rispetto al testo libero. Assicurati che il prompt istruisca chiaramente il modello a produrre solo JSON. Questa funzionalità funziona insieme alla chiamata di funzioni ma fornisce un'interfaccia più semplice quando ti servono solo dati strutturati senza definizioni di strumenti.

Utilizzo dei token e limiti

Il tuo account è limitato a 300 richieste al minuto e 8 richieste parallele per chiave. La dimensione massima del corpo della richiesta è 8 MB. Se superi questi limiti, l'API restituisce il codice di stato 429. Gli errori di autenticazione restituiscono 401, mentre il credito insufficiente restituisce 402. Il prezzo è $0,25 per milione di token di input e $1,00 per milione di token di output. Errori e rifiuti non consumano credito. La finestra di contesto è di 100.000 token in totale, inclusi sia prompt che completamento. Gestisci attentamente l'utilizzo dei token per evitare costi imprevisti. Il credito non scade mai e puoi ricaricarlo in qualsiasi momento usando criptovalute.

cURL

Copycurl https://api.groknsfw.cc/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."}]
  }'

Python

Copyfrom openai import OpenAI

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