API-Dokumentation

Schnellstart: Verbinden Sie Ihre erste Anfrage

Erstellen Sie zunächst Ihren Schlüssel im Dashboard. Die Base-URL für alle Anfragen ist HTTPS://api.filterno.cc/v1. Übergeben Sie Ihren Schlüssel im Authorization-Header als Bearer-Token. Diese Einrichtung funktioniert mit jedem Standard-OpenAI-kompatiblen Client.

Testen Sie die Konnektivität sofort mit einer einfachen Completion-Anfrage. Der Endpunkt akzeptiert Standard-Chat-Formate und gibt Rohtext ohne Inhaltsfilter zurück.

Ersetzen Sie YOUR_API_KEY durch die Zeichenfolge, die Ihrem Konto zugewiesen wurde. Der Anfragekörper definiert das Modell und den Nachrichtentext. Sie erhalten eine Antwort mit dem generierten Text.

Endpunkt: POST /v1/chat/completions

Senden Sie Ihre Prompts an POST /v1/chat/completions. Dies ist der einzige Chat-Endpunkt, den wir unterstützen. Sie geben eine Systemanweisung und Benutzernachrichten in einem Array-Format an.

Die Model-Kennung ist "uncensored". Sie verarbeitet Texteingaben und gibt Textausgaben zurück. Erwarten Sie hier keine Bild- oder Audioerstellung.

Legen Sie die Temperatur zur Steuerung der Zufälligkeit fest. Höhere Werte erzeugen kreativere Ausgaben. Niedrigere Werte liefern deterministische Ergebnisse. Die API hält sich strikt an das OpenAI-Schema für diesen Endpunkt.

Endpunkt: GET /v1/models

Überprüfen Sie verfügbare Modelle mit einer GET-Anfrage an /v1/models. Dieser Endpunkt gibt eine Liste unterstützter Modell-IDs zurück. Sie sollten "uncensored" in der Antwort sehen.

Dieser Endpunkt bestätigt, dass Ihr API-Schlüssel gültig ist. Er zeigt auch die Modell-Details an. Nutzen Sie ihn zum Debuggen von Verbindungsproblemen.

Die Antwort enthält die Modell-ID und den Objekttyp. Sie listet keine Preise oder Limits auf. Überprüfen Sie die Dokumentation für die Token-Sätze.

Parameter: Temperatur, Top-P und Tools

Steuern Sie die Ausgabevielfalt mit Temperatur und top_p. Temperatur passt die Wahrscheinlichkeitsverteilung an. Top_p filtert Tokens mit niedriger Wahrscheinlichkeit. Zusammen balancieren sie Kreativität und Fokus.

Nutze Function Calling für strukturierte Interaktionen. Definiere Tools im Anfragekörper. Das Modell kann diese Funktionen aufrufen. Übergebe tool_choice, um ein bestimmtes Verhalten durchzusetzen.

Setze Stop-Sequenzen, um die Generierung frühzeitig zu beenden. Verwende seed für reproduzierbare Ergebnisse. Presence- und Frequency-Penalties reduzieren Wiederholungen. Diese Parameter folgen den Standard-OpenAI-Konventionen.

Streaming-Antworten (SSE) & Token-Nutzung

Aktivieren Sie das Streaming, indem Sie stream auf true setzen. Die API gibt Server-Sent Events (SSE) zurück. Jeder Chunk enthält teilweise Token-Daten.

Die Token-Nutzung erscheint im letzten Chunk. Lesen Sie ihn, um die Kosten zu verfolgen. Streaming reduziert die wahrgenommene Latenz bei langen Antworten. Es ist ideal für Echtzeitanwendungen.

Die SSE-Datenstruktur sorgfältig parsen. Behandeln Sie Netzwerkunterbrechungen gracefully. Die API gewährleistet die Datenintegrität durch Chunk-Grenzen.

Limits, Fehler und Token-Arithmetik

Sie erhalten 300 Anfragen pro Minute pro Schlüssel. Die Parallelität ist auf 8 gleichzeitige Anfragen begrenzt. Die maximale Größe des Anfragekörpers beträgt 8 MB.

Das Context-Window umfasst 100.000 Tokens. Dies umfasst Eingabeaufforderung und Antwort. Maximale Ausgabe sind 16.000 Tokens. Festlegen Sie max_tokens, um die Nutzung zu begrenzen.

Behandeln Sie Fehler durch Überprüfung der Statuscodes. 401 bedeutet ungültiger Schlüssel. 402 zeigt kein Guthaben an. 429 signalisiert Rate Limit. Wiederholen Sie mit exponentiellem Backoff für 429.

cURL

Copycurl https://api.filterno.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top five risks in a standard React application."}]
  }'

Python

Copyfrom openai import OpenAI

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