Schnellstart für Ollama-Nutzer

Voraussetzungen

Um diese API zu nutzen, benötigst du ein aktives Konto mit einem gültigen API-Schlüssel. Registriere dich auf der API-Schlüssel erhalten-Seite mit Google oder einer E-Mail und einem Passwort. Eine Telefonnummer ist nicht erforderlich. Du musst außerdem ein unterstütztes Language SDK auf deinem Rechner installiert haben. Diese Anleitung deckt Python und Node.js ab, die gängigsten Clients für OpenAI-kompatible Endpunkte. Die API bietet ein einzelnes unzensiertes Modell mit der ID uncensored. Sie akzeptiert Text und gibt Text zurück. Es gibt keine Embedding-, Bild- oder Audio-Funktionen. Alle Anfragen gehen an https://api.ollamaapi.cc/v1.

SDK installieren

Installiere das offizielle SDK für deine bevorzugte Sprache. Für Python verwende pip. Für Node.js verwende npm. Diese Bibliotheken verarbeiten das HTTP-Protokoll, die JSON-Serialisierung und das Streaming automatisch. Du musst keine rohen HTTP-Anfragen schreiben, es sei denn, du bevorzugst diese Ebene der Kontrolle. Die SDKs sind gut dokumentiert und werden in Produktionsumgebungen häufig eingesetzt. Stelle sicher, dass deine Umgebung den SDK-Anforderungen entspricht. Python 3.8+ und Node.js 18+ werden empfohlen. Halte deine Abhängigkeiten auf dem neuesten Stand, um Kompatibilitätsprobleme mit neueren Modellparametern zu vermeiden.

Client konfigurieren

Lege die Basis-URL auf unseren Endpunkt fest. Dies ist die einzige Konfigurationsänderung, die erforderlich ist, um von OpenAI zu unserem unzensierten Dienst zu wechseln. Übergebe deinen API-Schlüssel als Autorisierungsheader. Das SDK erledigt den Rest. Ändere den Modellnamen nicht zu gpt-4 oder Ähnlichem; verwende uncensored. Die API hält sich strikt an das OpenAI-Chat-Completion-Protokoll. Jeder Client, der mit OpenAI funktioniert, funktioniert hier mit diesen zwei Änderungen. Dies macht Migrationen oder A/B-Tests einfach. Du kannst beide APIs nebeneinander ausführen, um Ausgaben zu vergleichen.

Erste Anfrage senden

Sende eine POST-Anfrage an /v1/chat/completions. Füge die Modell-ID, den System-Prompt und die Benutzer-Nachricht hinzu. Die API gibt eine Textantwort zurück. Wenn du Guthaben hast, gelingt die Anfrage. Fehlt dir das Guthaben, erhältst du einen 402-Fehler. Ist dein Schlüssel ungültig, erhältst du einen 401-Fehler. Diese Fehler sind standardisiert und einfach im Code zu behandeln. Das Modell lehnt rechtlich zulässige erwachsene Inhalte nicht ab, was es für kreatives Schreiben, Sicherheitsforschung oder unzensiertes Chat-Nutzen wertvoll macht. Prüfe dein Guthaben im Dashboard, wenn du unsicher bezüglich der verbleibenden Credits bist.

Streaming-Antworten

Aktiviere das Streaming, indem du stream: true setzt. Die API gibt Token zurück, sobald sie generiert werden. Dies reduziert die wahrgenommene Latenz für Nutzer. Das letzte Chunk enthält die gesamte Token-Nutzung für die Abrechnung. Streaming wird von allen offiziellen SDKs unterstützt. Es ist essenziell für Chat-Oberflächen, in denen du Text so anzeigen möchtest, wie er geschrieben wird. Der Server sendet Server-Sent Events (SSE). Deine Client-Bibliothek übernimmt das Parsing. Du musst den Event-Stream nicht manuell verwalten, es sei denn, du baust einen benutzerdefinierten Client.

Limits, Fehler und Kontext

Das Kontextfenster umfasst insgesamt 100.000 Token, mit einem maximalen Output von 32.000 Token. Anfragen sind auf 300 pro Minute und 8 parallele Anfragen pro Schlüssel begrenzt. Der Anfragetextkörper muss unter 8 MB liegen. Fehler umfassen 401 für ungültige Schlüssel, 402 für unzureichendes Guthaben und 429 für Ratenlimits. Dies sind Standard-HTTP-Codes. Verarbeite sie in deiner Anwendung angemessen. Das Modell blockiert sexuelle Inhalte, die Minderjährige betreffen. Alle anderen Inhalte sind erlaubt. Das Guthaben verfällt nie, sodass du die Nutzung pausieren kannst, ohne Geld zu verlieren. Nutze die Support-Seite bei Rückerstattungsproblemen.

cURL

Copycurl https://api.ollamaapi.cc/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

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

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)