Guida rapida per gli utenti Grok
Migra le tue integrazioni API Grok esistenti al nostro endpoint OpenAI compatibile senza censura in pochi minuti. Questa guida copre la configurazione SDK, lo streaming, la chiamata di funzioni e i vincoli chiave per gli sviluppatori che cercano una soluzione pronta all'uso.
Installa l'SDK OpenAI
La nostra API segue lo schema standard chat-completions, quindi puoi riutilizzare gli SDK ufficiali OpenAI per Python, Node.js e altri linguaggi. Assicurati di avere installata l'ultima versione della libreria client preferita. Questo approccio ti permette di mantenere intatta la logica della tua applicazione esistente mentre sostituisci l'URL di base e la chiave di autenticazione. Non hai bisogno di un client personalizzato o di uno strato di routing complesso. L'unico requisito è che il tuo codice supporti i parametri standard compatibili con OpenAI come model, messages e stream.
Configura Base URL e chiave
Indirizza il client SDK al nostro base URL: https://api.uncensoredgrok.com/v1. Imposta il parametro del modello su uncensored per accedere al nostro modello a pesi aperti. Recupera la tua chiave API dalla pagina "Ottieni chiave API" dopo esserti registrato con solo email e password. Non è necessaria una carta di credito per iniziare. La chiave viene visualizzata immediatamente dopo la registrazione e può essere rigenerata in qualsiasi momento, invalidando la chiave precedente. Questa semplice configurazione garantisce che le tue richieste vengano instradate correttamente ai nostri server GPU senza livelli di routing o aggregazione del modello nascosti.
Invia la tua prima completazione
Esegui una richiesta POST standard a /v1/chat/completions. Il modello accetta input testuali e restituisce output testuali. È importante notare che non offriamo endpoint per embeddings, generazione di immagini, elaborazione audio o fine-tuning. È disponibile solo l'endpoint chat-completions. Il nostro modello è ottimizzato per rispondere senza rifiuti di contenuto per argomenti adulti leciti, di fantasia o controversi. Tuttavia, si applica sempre un limite rigido: le richieste contenenti contenuti sessuali che coinvolgono minori vengono bloccate. Per tutti gli altri contenuti leciti, il modello elabora le richieste direttamente senza filtri intermedi.
Abilita le risposte in streaming
Abilita lo streaming impostando il parametro stream su true nella tua richiesta. L'API restituisce Server-Sent Events (SSE) che puoi analizzare token per token. Questo è ideale per esperienze utente in tempo reale. Il formato della risposta corrisponde al protocollo di streaming standard OpenAI, quindi i tuoi parser di streaming esistenti dovrebbero funzionare senza modifiche. Puoi gestire i token parziali man mano che arrivano, riducendo la latenza percepita per gli utenti. Questa funzione è supportata sull'endpoint chat-completions e funziona perfettamente con gli SDK Python e Node.js.
Utilizza la chiamata di funzioni
La chiamata di funzioni e di strumenti è completamente supportata. Puoi definire gli strumenti nel parametro tools e lasciare che il modello decida quando chiamarli. La risposta include chiamate di strumenti che puoi eseguire nella logica della tua applicazione, per poi restituire i risultati alla conversazione. Questo abilita flussi di lavoro complessi senza bisogno di orchestrazione esterna. Il modello gestisce le definizioni e l'invocazione degli strumenti in modo trasparente. Nota che non offriamo routing del modello o scelte multiple di modelli; questo singolo modello senza censura gestisce tutte le interazioni con gli strumenti nativamente.
Limiti, errori e finestra di contesto
Il nostro modello supporta una finestra di contesto di 100.000 token, combinando sia i token del prompt che quelli di completamento. Il limite di dimensione del corpo della richiesta è di 8 MB. Hai a disposizione 300 richieste al minuto per chiave API. Se ricevi un errore 401, la tua chiave non è valida o è scaduta. Un errore 402 indica credito prepagato insufficiente. Un errore 429 significa che hai superato il limite di richieste. I prezzi sono trasparenti: $0,15 per 1M di token di input e $0,50 per 1M di token di output. I crediti non scadono mai. Controlla l'endpoint dei modelli disponibili per confermare che l'ID del modello sia uncensored.
cURL
curl https://api.uncensoredgrok.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."}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredgrok.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)Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.uncensoredgrok.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);Streaming
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)Specifiche tecniche
Tutti i limiti e le funzioni reali dell'API in un unico posto: controllali prima di ricaricare.
| Voce | Valore |
|---|---|
| Formato | compatibile OpenAI: qualsiasi SDK OpenAI funziona cambiando base URL e chiave |
| Base URL | https://api.uncensoredgrok.com/v1 |
| Endpoint | POST /v1/chat/completions · GET /v1/models |
| ID modello | uncensored |
| Autenticazione | Authorization: Bearer YOUR_KEY |
| Output massimo | fino al resto della finestra di 100.000 token; max_tokens opzionale (nessun limite separato) |
| Parametri | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Streaming | sì — server-sent events; l'ultimo blocco riporta l'uso dei token |
| Finestra di contesto | 100.000 token (input + output) |
| Function calling | sì — tools, tool_choice; risposte con tool_calls anche in streaming; risultati come role: tool |
| Modalità JSON | response_format: {"type": "json_object"} |
| Limite di frequenza | 300 richieste al minuto per chiave |
| Dimensione | fino a 8 MB per richiesta |
| Header | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Concorrenza | 8 richieste contemporanee per chiave |
| Bonus | +5% da $50, +10% da $100, +15% da $200 |
| Prezzo | $0,15 per 1M token in input · $0,50 per 1M in output |
| Prova gratuita | $0,50 per 7 giorni, senza carta · Chiave di prova: 2 richieste parallele, 60 al minuto; limiti completi (8 e 300) dopo la prima ricarica |
| Ricarica | USDT (TRC20) o USDC (Base), qualsiasi importo intero da $20 a $500 |
| Fatturazione | credito prepagato in base all'uso reale; errori e rifiuti gratuiti |
| Scadenza | il credito pagato non scade, nessun abbonamento |
| Accesso | Google oppure e-mail e password |
| Contenuti | contenuti per adulti consentiti; rifiutati i contenuti sessuali con minori |
| Chiavi | una chiave attiva per account; una nuova sostituisce la precedente |
Codici di errore
Gli errori arrivano in JSON con un type fisso; le richieste fallite o rifiutate non si pagano.
| Codice | Tipo | Significato |
|---|---|---|
400 | bad_request | JSON non valido, messaggi vuoti, parametro errato o contesto troppo lungo |
401 | missing_key · invalid_key · key_revoked | chiave mancante, errata o sostituita |
402 | no_credit | credito esaurito — ricarica e riparti subito |
403 | content_blocked | contenuti sessuali con minori — rifiutato, non addebitato |
404 | not_found | endpoint sconosciuto |
413 | request_too_large | corpo oltre 8 MB |
429 | rate_limited · concurrency | oltre 300/min o 8 in parallelo — attendi e riprova |
503 | upstream_busy | modello occupato — riprova tra pochi secondi |
Domande e risposte
Questa è l'API ufficiale di Grok?
No. Siamo un servizio indipendente. Non siamo OpenAI, xAI né alcun altro fornitore. Il nostro modello è un modello a pesi aperti eseguito sui nostri server, ottimizzato per risposte senza censura. È compatibile con il formato dell'API Grok ma è un prodotto distinto.
Utilizzate i miei prompt per l'addestramento?
No. I prompt inviati alla nostra API non vengono utilizzati per l'addestramento. Ci concentriamo sull'utilità pura dell'API. La privacy dei tuoi dati è mantenuta senza richiedere accordi aziendali complessi.
Cosa succede se rimango senza crediti?
Le richieste restituiranno un errore 402 fino a quando non ricaricherai il tuo credito prepagato. Puoi pagare con criptovalute (USDT o USDC) a partire da $20. I crediti non scadono mai, quindi puoi mettere in pausa e riprendere l'utilizzo al tuo ritmo.
La tua chiave è a un modulo di distanza
Crea un account, copia la chiave, modifica l'URL di base. È tutta qui la configurazione.