URL base e autenticazione
La nostra API segue lo standard OpenAI Chat Completions. Per interagire con il servizio, devi indirizzare il tuo client a https://api.grokapikey.com/v1 e includere la tua chiave API unica nell'intestazione Authorization. Puoi generare questa chiave immediatamente dopo esserti registrato con solo email e password. La chiave viene visualizzata una sola volta alla creazione, quindi salvala in modo sicuro. Se la perdi, puoi rigenerare una nuova chiave dal tuo pannello, il che revoca istantaneamente quella precedente. Non è necessario collegare una carta di credito per l'account di prova.
La tua prima richiesta
Inizia inviando un prompt di testo semplice per verificare la connettività. Usa l'endpoint standard chat/completions con l'identificatore del modello uncensored. L'esempio seguente mostra un comando curl di base per testare la connessione. Questo conferma che la tua autenticazione è corretta e che il servizio sta rispondendo. Puoi poi adattare questa struttura alla logica della tua applicazione specifica.
Sostituisci YOUR_API_KEY con la tua chiave effettiva prima di eseguire questo comando.
curl https://api.grokapikey.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
Se stai sviluppando un'applicazione Python, usa la libreria ufficiale openai. Configura il client per utilizzare il nostro URL base e la tua chiave API. Questo ti permette di sfruttare le consuetudini Python familiari mentre accedi al modello senza censura. Il client gestisce automaticamente la serializzazione e lo streaming. Assicurati che il tuo ambiente abbia installata l'ultima versione della libreria per la migliore compatibilità con i nostri endpoint.
from openai import OpenAI
client = OpenAI(base_url="https://api.grokapikey.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 progetti JavaScript o TypeScript, l'SDK OpenAI per Node.js è pronto all’uso. Imposta le proprietà apiKey e baseURL nel tuo oggetto di configurazione. Questo garantisce che tutte le richieste successive vengano instradate attraverso la nostra infrastruttura. Puoi utilizzare i pattern standard async/await per gestire le risposte. Questo approccio è ideale per applicazioni server-side o funzioni edge che richiedono accesso diretto all'API senza effettuare proxying tramite OpenAI.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.grokapikey.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
Per le applicazioni che traggono vantaggio dalla generazione di token in tempo reale, abilita lo streaming impostando stream: true nel corpo della richiesta. L'API restituisce un flusso di Server-Sent Events (SSE) con risposte parziali. Questo riduce la latenza percepita per gli utenti e consente la visualizzazione immediata del testo generato. Ogni chunk contiene un delta della risposta. Gestisci questi eventi nel codice client per aggiornare progressivamente l'interfaccia utente. Lo streaming consuma i token normalmente e non influisce sui prezzi.
stream = 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
Ogni chiave API è limitata a 300 richieste al minuto e a una dimensione massima del corpo della richiesta di 8 MB. Se superi il limite di richieste, l'API restituisce un codice di stato 429; attendi qualche secondo e riprova. Un errore 401 indica una chiave non valida o revocata, mentre un errore 402 significa che il tuo credito prepagato è esaurito. Il modello supporta una finestra di contesto di 100.000 token per input e output combinati. Assicurati che i tuoi prompt rientrino in questo limite per evitare troncamenti. I filtri sui contenuti rimangono minimi, tranne un blocco rigido sui contenuti sessuali che coinvolgono minori.
