Uncensored API-Schnellstartanleitung

Authentifizierung und Base URL

Richten Sie Ihr SDK auf unsere Basis-URL ein und übergeben Sie Ihren Schlüssel im Authorization-Header. Wir bieten einen direkten, Single-Model-Dienst ohne Proxy-Routing-Gebühren. Verwenden Sie den Standard Authorization: Bearer Schema zur Authentifizierung von Anfragen. Ihr Schlüssel wird sofort nach der Anmeldung über Google oder E-Mail generiert. Stellen Sie sicher, dass Sie den Platzhalter-Schlüssel in Ihrer Client-Konfiguration durch den auf Ihrem Dashboard angezeigten Schlüssel ersetzen. Die Basis-URL ist https://api.uncensoredmodelsollama.com/v1. Dieser Endpunkt unterstützt standardmäßige OpenAI-kompatible Clients und ermöglicht es Ihnen, Anbieter zu wechseln, ohne Ihre Anwendungslogik neu schreiben zu müssen. Bewahren Sie Ihren Schlüssel sicher auf, da er Zugriff auf Ihren vorausbezahlten Guthaben-Bestand gewährt.

Chat-Vervollständigungs-Endpunkt

Senden Sie Textanfragen an das /v1/chat/completions Endpunkt zur Generierung von Antworten. Dieser Endpunkt verarbeitet Standard-Konversationsverläufe und System-Prompts. Sie müssen die Modell-ID als uncensored im Anfragekörper. Die API gibt JSON-formatierte Antworten zurück, die den generierten Text und die Token-Nutzungsstatistiken enthalten. Fehler wie unzureichendes Guthaben oder ungültige Schlüssel werden mit entsprechenden HTTP-Statuscodes zurückgegeben. Nutzen Sie diesen Endpunkt für alle Standard-Textgenerierungsaufgaben. Er unterstützt keine Embeddings, Bilder oder Feinabstimmungen. Halten Sie Ihren Payload unter 8 MB, um eine zuverlässige Verarbeitung zu gewährleisten. Das Modell verarbeitet Eingabe- und Ausgabetokens innerhalb eines gemeinsamen Kontextfensters.

Streaming-Antworten

Aktivieren Sie das Streaming, indem Sie den stream Parameter auf true setzen in Ihrer Anfrage. Die API gibt Server-Sent Events (SSE) zurück, die inkrementale Textchunks enthalten. Dieser Ansatz reduziert die wahrgenommene Latenz für Benutzer, die auf lange Ausgaben warten. Sie erhalten Token-Nutzungsinformationen im letzten Chunk des Streams. Implementieren Sie einen Stream-Handler in Ihrem Client, um diese Ereignisse effizient zu verarbeiten. Streaming ist ideal für Chat-Schnittstellen und Echtzeitanwendungen. Stellen Sie sicher, dass Ihre Client-Bibliothek die SSE-Parsing unterstützt, um den kontinuierlichen Datenfluss korrekt zu handhaben. Das gesamte Kontextfenster bleibt bei 100.000 Tokens unabhängig vom Streaming-Modus.

Function Calling und JSON-Modus

Nutzen Sie die tools Parameter zur Aktivierung der Function-Calling-Fähigkeiten. Definieren Sie Ihre Funktionen im Request-Body, um dem Modell die Rückgabe strukturierter Daten zu ermöglichen. Setzen Sie response_format zu {"type": "json_object"} für strikte JSON-Ausgabe. Diese Funktion ist nützlich zum Extrahieren von Daten oder zum Generieren strukturierter Payloads. Das Modell unterstützt Tool-Auswahlparameter, um das Verhalten der Funktionsaufrufe zu steuern. Nutzen Sie diese Funktionen, um die API in automatisierte Workflows zu integrieren. Stellen Sie sicher, dass Ihre Funktionsdefinitionen mit dem erwarteten Eingabeschema übereinstimmen, um zuverlässige Ergebnisse zu erzielen. Die API gibt Tool-Aufrufe im Standard-OpenAI-Format zurück, um ein einfaches Parsing zu ermöglichen.

Parameter und Ratenlimits

Passen Sie das Generierungsverhalten mit Parametern wie temperature, top_p, und seed. Legen max_tokens die Ausgabelänge zu begrenzen, mit einem Standardwert von 2.048, falls nicht angegeben. Die API erzwingt ein Rate-Limit von 300 Anfragen pro Minute pro Schlüssel. Gleichzeitige Anfragen sind auf 8 pro Schlüssel begrenzt. Wenn Sie diese Limits überschreiten, gibt die API einen 429-Statuscode zurück. Anfragen werden basierend auf der tatsächlichen Token-Nutzung berechnet, wobei Fehler und Ablehnungen kostenlos sind. Guthaben verfällt nie, und Prepaid-Beträge sind transparent. Verwalten Sie Ihre Schlüssel sorgfältig, da jedes Konto nur einen aktiven Schlüssel unterstützt.

Limits, Fehler und Kontext

Das Context-Window unterstützt 100.000 Tokens für kombinierte Eingabe und Ausgabe. Anfragen, die das 8-MB-Body-Limit überschreiten, schlagen fehl. Häufige Fehler sind 401 für ungültige Schlüssel und 402 für unzureichendes Guthaben. Behandeln Sie diese Fehler in Ihrer Anwendungslogik angemessen. Die API lehnt Anfragen ab, die Sexualinhalte mit Minderjährigen enthalten, unabhängig von anderen Einstellungen. Andere Inhalte bleiben für die rechtmäßige Nutzung durch Erwachsene unzensiert. Überwachen Sie Ihre Token-Nutzung, um unerwartete Gebühren zu vermeiden. Das Prepaid-Guthabensystem stellt sicher, dass Sie nur für das bezahlen, was Sie nutzen. Keine Abo-Gebühren oder versteckten Kosten gelten für Ihre Integration.

cURL

Copycurl https://api.uncensoredmodelsollama.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List all available models in the ollama library."}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

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)