Prima richiesta in cinque minuti
Integra la nostra API senza censura nel tuo flusso di lavoro AI NSFW aggiornando tre valori di configurazione nel tuo client compatibile con OpenAI. Questa guida rapida copre l'autenticazione, la generazione di testo e lo streaming senza dipendenze aggiuntive.
URL base e autenticazione
La nostra API replica l'interfaccia OpenAI v1, consentendoti di sostituire gli endpoint senza modificare la logica della tua applicazione. Usa https://api.groknsfw.top/v1 come URL di base. L'autenticazione richiede una chiave API valida passata nell'header Authorization come token Bearer. Puoi generare questa chiave istantaneamente tramite accesso con Google o email dal cruscotto. Ogni account supporta una sola chiave attiva alla volta; l'emissione di una nuova chiave invalida immediatamente quella precedente. Questo modello a chiave singola semplifica il controllo degli accessi per la maggior parte degli ambienti di sviluppo e QA.
Prima richiesta
Invia una richiesta standard di completamento chat per testare la connettività. L'identificatore del modello è uncensored, che gestisce i rifiuti di contenuto in modo diverso rispetto ai modelli standard. Di seguito è riportato un esempio di base che utilizza lo strumento da riga di comando curl per verificare che la tua chiave e l'URL base siano corretti.
curl https://api.groknsfw.top/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."}]
}'
Se ricevi una risposta JSON con choices e usage, la tua integrazione è attiva. Controlla l'oggetto usage per vedere il consumo di token per un tracciamento accurato della fatturazione.
Integrazione SDK Python
Utilizza il pacchetto Python ufficiale openai per interagire con il nostro endpoint. Imposta gli attributi base_url e api_key prima di effettuare le chiamate. Questo approccio funziona con qualsiasi libreria che supporta lo schema OpenAI, rendendo la migrazione da altri fornitori semplice.
from openai import OpenAI
client = OpenAI(base_url="https://api.groknsfw.top/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)
Questo frammento di codice dimostra una richiesta sincrona. Per la generazione di contenuti NSFW ad alto throughput, considera l'utilizzo di client asincroni per gestire più richieste in parallelo senza bloccare il thread principale.
Configurazione SDK Node.js
Per le applicazioni JavaScript o TypeScript, configura l'SDK OpenAI per puntare al nostro URL base. Questo garantisce che il tuo codice client esistente funzioni senza modifiche. L'ecosistema Node.js beneficia di questa compatibilità, consentendo un rapido prototipaggio di interfacce chat NSFW.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.groknsfw.top/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);
Assicurati di utilizzare una versione recente dell'SDK che supporti URL base personalizzati. L'oggetto di configurazione deve includere rigorosamente le proprietà apiKey e baseURL per evitare disallineamenti degli endpoint.
Risposte in streaming (SSE)
Abilita la generazione di token in tempo reale impostando stream: true nella tua richiesta. L'API restituisce uno stream Server-Sent Events (SSE), consegnando i token man mano che vengono generati. Questo riduce la latenza percepita per gli utenti finali nelle applicazioni di chat.
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)
Analizza gli eventi SSE per estrarre il contenuto delta. L'ultimo chunk dello stream contiene le statistiche totali usage, che dovresti utilizzare per la riconciliazione accurata della fatturazione. Lo streaming non influisce sul conteggio dei token o sui prezzi.
Limiti, errori e contesto
Le tue richieste sono soggette a un limite di 300 al minuto e 8 richieste parallele per chiave. La dimensione massima del corpo della richiesta è 8 MB e la finestra di contesto supporta fino a 100.000 token in totale. Gli errori vengono restituiti in formati HTTP standard: 401 per chiavi non valide, 402 per credito insufficiente e 429 per i limiti di richieste. Gli errori sul credito sono gratuiti, ma i limiti di richieste richiedono di ridurre il flusso delle richieste. L'output massimo per richiesta è di 32.000 token; l'omissione di max_tokens porta a un default di 2.048 token.
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 |
| Autenticazione | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.groknsfw.top/v1 |
| Endpoint | POST /v1/chat/completions · GET /v1/models |
| ID modello | uncensored |
| Modalità JSON | response_format: {"type": "json_object"} |
| 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 |
| Function calling | sì — tools, tool_choice; risposte con tool_calls anche in streaming; risultati come role: tool |
| Finestra di contesto | 100.000 token (input + output) |
| Streaming | sì — server-sent events; l'ultimo blocco riporta l'uso dei token |
| Header | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Limite di frequenza | 300 richieste al minuto per chiave |
| Concorrenza | 8 richieste contemporanee per chiave |
| Dimensione | fino a 8 MB per richiesta |
| Fatturazione | credito prepagato in base all'uso reale; errori e rifiuti gratuiti |
| 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 |
| Scadenza | il credito pagato non scade, nessun abbonamento |
| Bonus | +5% da $50, +10% da $100 |
| Prezzo | $0,25 per 1M token in input · $1,00 per 1M in output |
| Ricarica | USDT (TRC20) o USDC (Base), qualsiasi importo intero da $10 a $500 |
| Accesso | Google oppure e-mail e password |
| Chiavi | una chiave attiva per account; una nuova sostituisce la precedente |
| Contenuti | contenuti per adulti consentiti; rifiutati i contenuti sessuali con minori |
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
È l'API ufficiale di Grok?
No, siamo un servizio indipendente che ospita un modello a pesi aperti ottimizzato per risposte senza censura. Utilizziamo lo stesso protocollo API di OpenAI, ma il nostro modello non è GPT-4, Grok o qualsiasi altro modello di un fornitore. Consulta la documentazione del fornitore per i dettagli specifici del modello.
Come ottengo più chiavi API?
Ogni account è limitato a una sola chiave API attiva alla volta. La generazione di una nuova chiave dal cruscotto invaliderà immediatamente la chiave precedente. Questo design semplifica la gestione degli accessi per singoli sviluppatori e piccoli team.
Supportate la chiamata di funzioni?
Sì, l'API supporta la chiamata di funzioni standard tramite i parametri <code>tools</code> e <code>tool_choice</code>. Puoi anche forzare l'output JSON utilizzando <code>response_format: { "type": "json_object" }</code> per la generazione di dati strutturati.
La tua chiave è a un modulo di distanza
Crea un account, copia la chiave, modifica l'URL base. È tutta qui la configurazione.