Guida rapida API Opensfw

Autenticazione e Base URL

Inizia generando la tua chiave sulla dashboard. Usa il https://api.opensfw.com/v1 URL di base e imposta la tua chiave API in Authorization header. Questa configurazione funziona con qualsiasi client SDK standard di OpenAI.

Esecuzione della tua prima richiesta di chat completion

Invia una richiesta POST a /v1/chat/completions con il tuo ID modello e i messaggi. Il modello uncensored elabora il tuo input e restituisce il testo generato. Usa l'esempio curl seguente per verificare la connettività.

Copycurl https://api.opensfw.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the current release version of the model?"}]
  }'

Risposte in streaming e utilizzo dei token

Abilita lo streaming impostando stream: true nella tua richiesta. Ricevi blocchi di testo man mano che vengono generati. Il blocco finale contiene le statistiche complete sull'utilizzo dei token per la fatturazione. Utilizza l'esempio Python per gestire lo stream.

Copyfrom openai import OpenAI

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

Function calling e modalità JSON

Definisci gli strumenti nella richiesta per output strutturati. Usa response_format: {"type": "json_object"} per risposte JSON rigorose. Questo funziona perfettamente con i parametri standard di function calling.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.opensfw.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);

Gestione degli errori e dei limiti di frequenza

Verifica la presenza di 401 se la tua chiave non è valida, 402 per credito insufficiente, e 429 per i limiti di frequenza. Hai 300 richieste al minuto e 8 richieste concorrenti per chiave. Gli errori non consumano token.

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)

Comprendere le finestre di contesto e i limiti

Il modello uncensored supporta una finestra di contesto di 100,000 token. Prompt e completamento insieme. L'output massimo è di 16,000 token per richiesta. Mantieni il corpo della richiesta sotto gli 8 MB. Questo garantisce prestazioni costanti per input di grandi dimensioni.