Integrationsleitfaden

Schnellstart: Ihre erste Anfrage

Die API ist eine OpenAI-kompatible API, die die Chat-Completions-Struktur abbildet. Sie senden Text, erhalten Text zurück. Keine zusätzlichen Endpunkte für Embeddings oder Audio, die Ihren Workflow überladen. Starten Sie, indem Sie Ihren Client auf unsere Basis-URL zeigen.

• Basis-URL: HTTPS://api.filtrosemia.com/v1
• Modell-ID: "uncensored"

Ersetzen Sie Ihre bestehende Base-URL in Ihrer SDK-Konfiguration. Der Endpunkt erledigt alles von Roleplay bis Übersetzung ohne die üblichen Filter.

Copycurl https://api.filtrosemia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "check balance"}]
  }'

Authentifizierung und Header

Übergeben Sie Ihren API-Schlüssel im Standard-Authorization-Header. Wir verwenden für die Einfachheit einen aktiven Schlüssel pro Konto. Wenn Sie einen neuen Schlüssel benötigen, generieren Sie ihn über Ihr Dashboard.

• Header: Authorization: Bearer YOUR_API_KEY
• Keine OAuth-Flows oder Refresh-Tokens zu verwalten.

Halten Sie Ihren Schlüssel sicher. Er gewährt direkten Zugriff auf Ihr bezahltes Guthaben. Fehler wie 401 Unauthorized Bedeutet, dass der Schlüssel fehlt oder ungültig ist.

Copyfrom openai import OpenAI

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

Chat-Vervollständigungs-Endpunkt

Senden Sie Nachrichten an POST /v1/chat/completions. Das Modell unterstützt Standardparameter wie temperature, top_p, und stop Sequenzen. Es ist ein unzensiertes Modell, das auf erwachsene und kreative Inhalte abgestimmt ist.

• Unterstützt json_object Antwortformat.
• Akzeptiert Tool-Definitionen für Function Calling.

Anfragen werden innerhalb Ihrer Rate-Limits sequenziell verarbeitet. Stellen Sie sicher, dass Ihre Payload unter 8 MB bleibt.

Copyimport OpenAI from "openai";

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

Verwenden Sie Server-Sent Events für die Echtzeit-Übertragung von Tokens. Dies reduziert die wahrgenommene Latenz bei langen Ausgaben. Der letzte Chunk enthält die vollständigen Token-Nutzungsstatistiken.

• Festlegen stream: true in Ihrer Anfrage.
• Analysieren Sie den SSE-Stream in Ihrem Client.

Das Streaming funktioniert identisch zum Verhalten des Standard-OpenAI-SDK. Sie verarbeiten die Chunks, sobald sie eintreffen.

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)

Kontextfenster und Grenzen

Das Modell unterstützt einen 100.000-Token-Context-Window. Dies ermöglicht hohe Lasten mit langen Verläufen. Die maximale Ausgabe beträgt 16.000 Tokens pro Anfrage.

• Standardmaximalausgabe: 2.048 Tokens.
• Rate-Limit: 300 Anfragen pro Minute.

Das Überschreiten der Grenzen löst einen 429 Too Many Requests Fehler. Passen Sie Ihre Parallelität an, um innerhalb der Grenzen zu bleiben. Pro Schlüssel sind 8 gleichzeitige Anfragen erlaubt.

Fehlerbehandlung und Tokens

Verwalten Sie Standard-HTTP-Fehler. 402 Payment Required Bedeutet, dass Ihr Prepaid-Guthaben aufgebraucht ist. 429 gibt Rate-Limiting an. 401 signals authentication issues.

• Fehler sind kostenlos. Sie zahlen nur für erfolgreiche Token-Nutzung.
• Ablehnungen aufgrund der Inhaltsrichtlinie sind ebenfalls kostenlos.

Prüfen Sie den Antwortkörper auf detaillierte Fehlermeldungen. Nutzen Sie diese, um Ihre Wiederholungslogik oder die Häufigkeit der Guthabenaufladung anzupassen.