Guida rapida per utenti di Ollama NSFW

Prerequisiti e Autenticazione

Hai bisogno di una chiave API e dell'URL di base per iniziare. Iscriviti alla pagina Ottieni chiave API utilizzando Google o email. La tua chiave appare immediatamente; non è richiesta una carta per la prova. L'URL di base è https://api.ollamansfw.com/v1. Impostalo nel tuo ambiente o nella configurazione dell'SDK. L'identificatore del modello è uncensored. È un modello a pesi aperti in esecuzione sui nostri server, distinto da GPT o da altri modelli di fornitori.

La tua prima richiesta

Invia una richiesta standard di completamento chat. L'API si aspetta un array messages con role e content. Usa curl per testare la connettività. Sostituisci YOUR_API_KEY con la tua chiave effettiva. La risposta restituisce il testo generato in choices[0].message.content. Se ricevi un 401, controlla la tua chiave. Un 402 significa che ti serve credito.

Integrazione SDK Python

Usa il pacchetto Python ufficiale openai. Installalo tramite pip. Configura il client con l'URL di base personalizzato e la chiave API. Questo garantisce la compatibilità con il nostro endpoint. Il codice sottostante dimostra una semplice generazione di testo. Gestisce la richiesta e stampa il risultato. La gestione degli errori dovrebbe catturare le eccezioni HTTP. Questo approccio funziona per qualsiasi client compatibile con OpenAI.

Integrazione SDK Node.js

Installa il pacchetto Node.js openai. Imposta l'URL di base e la chiave API nell'inizializzazione del client. La struttura rispecchia l'esempio Python. Passa l'ID del modello uncensored. La risposta contiene i dati di completamento. Usa async/await per un codice pulito. Questo metodo è ideale per applicazioni server-side o strumenti CLI che necessitano di accesso diretto all'API.

Risposte in streaming

Abilita lo streaming impostando stream: true. L'API restituisce uno stream di eventi inviati dal server (SSE). Ogni chunk contiene testo parziale. L'ultimo chunk include le statistiche di utilizzo dei token. Questo riduce la latenza percepita per le risposte lunghe. Gestisci gli errori dello stream in modo elegante. Gli SDK forniscono iteratori per lo streaming integrati. Elabora ogni chunk per aggiornare l'UI in tempo reale.

Limiti, errori e contesto

La finestra di contesto è di 100.000 token in totale. L'output può estendersi fino alla fine della finestra. I limiti di velocità sono di 300 richieste al minuto. Le richieste parallele sono limitate a 8 per chiave. I corpi delle richieste devono essere inferiori a 8 MB. Errori comuni: 401 (chiave non valida), 402 (credito insufficiente), 429 (limite di velocità). Gli errori non consumano credito. I rifiuti per contenuti illeciti sono gratuiti. Il credito non scade mai.

cURL

Copiacurl https://api.ollamansfw.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

Copiafrom openai import OpenAI

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

Copiaimport OpenAI from "openai";

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

sì — server-sent events; l'ultimo blocco riporta l'uso dei token

Copiastream = 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)