Documentazione API
Ottieni la tua chiave API e inizia a inviare richieste immediatamente. Questa guida copre gli endpoint essenziali, l'autenticazione e gli esempi di codice per integrare il nostro LLM uncensored nella tua applicazione.
Autenticazione e Base URL
L'URL di base è HTTPS://api.nsfwcom.com/v1. Aggiungi la tua chiave API all' Authorization header come token bearer. Questo header autentica ogni richiesta inviata all'endpoint.
- Includi la tua chiave in ogni richiesta.
- Mantieni la chiave sicura e non condividerla pubblicamente.
Genera la tua chiave tramite la dashboard e inizia subito l'integrazione.
Endpoint Chat Completions
Invia una richiesta POST a /v1/chat/completions con i tuoi messaggi e il nome del modello. L'API restituisce completamenti di testo in base al tuo prompt.
curl https://api.nsfwcom.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List the top five benefits of remote work for engineers"}]
}'Usa l'ID del modello uncensored per garantire output coerenti e non filtrati per il tuo caso d'uso. Configura parametri come temperature per controllare la creatività.
SDK Python
Utilizza la libreria Python ufficiale di OpenAI per interagire con l'API in modo semplice. Imposta l'URL di base sul nostro endpoint e fornisci la tua chiave API.
from openai import OpenAI
client = OpenAI(base_url="https://api.nsfwcom.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)Questo approccio permette di sfruttare i metodi SDK familiari per le completazioni della chat. È possibile passare liste di messaggi e ricevere risposte di testo strutturate direttamente negli script Python.
SDK Node
Installa il pacchetto OpenAI Node.js e configuralo con il nostro URL di base. Questo ti permette di integrare l'API nei tuoi progetti JavaScript o TypeScript senza problemi.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.nsfwcom.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);Definisci il tuo array di messaggi e chiama l'endpoint di completamento. L'SDK gestisce le richieste HTTP e l'analisi, restituendo il testo generato per la logica della tua applicazione.
Risposte in streaming tramite SSE
Abilita lo streaming impostando stream: true nella tua richiesta. L'API restituisce Server-Sent Events (SSE) per la consegna dei token in tempo reale.
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 lo stream per visualizzare i token man mano che vengono generati. Questo migliora l'esperienza utente mostrando i progressi istantaneamente. L'ultimo chunk contiene l'utilizzo totale dei token per la fatturazione.
Limiti, Errori e Contesto
La finestra di contesto supporta un totale di 100.000 token. Monitora i limiti delle tue richieste per evitare interruzioni del servizio. Gli errori comuni includono 401 per chiavi non valide, 402 per credito insufficiente, e 429 per i limiti di frequenza.
I rimborsi non vengono emessi per il credito consumato. Gli errori durante l'elaborazione non consumano token. Usa questi codici per gestire i guasti con grazia nella tua applicazione.
Domande comuni
Come iniziare con l'API nsfw.com?
Registrati tramite Google o email per ricevere la tua chiave API istantaneamente. Aggiungi un credito cripto al tuo account e invia la tua prima richiesta utilizzando i campioni di codice forniti.
Cosa succede se rimango senza credito?
Le richieste restituiranno un errore 402 fino a quando non effettui un ricarico. Il credito non scade mai, quindi puoi aggiungere fondi quando sei pronto a continuare a utilizzare il servizio.
L'API supporta lo streaming?
Sì, imposta il parametro stream su true per ricevere Server-Sent Events. Questo ti permette di visualizzare i token man mano che vengono generati per un'esperienza utente più rapida.
Proteggi la tua chiave API
Registra un account, recupera la tua chiave e aggiorna il tuo base URL. La configurazione richiede secondi.