API-Dokumentation

Basis-URL und Authentifizierung

Verbinde deine Anwendung, indem du auf unseren dedizierten Endpunkt verweist und deinen eindeutigen API-Key übergibst. Die Base-URL für alle Anfragen ist https://api.apertusapp.com/v1. Sie erhalten Ihren Schlüssel sofort nach der Anmeldung über Google oder E-Mail auf der API-Schlüssel erhalten Seite. Fügen Sie diesen Schlüssel in die Authorization header für jede Anfrage.

Copycurl https://api.apertusapp.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run curl test with empty headers"}]
  }'

Jedes Konto generiert einen aktiven Schlüssel. Wenn Sie einen neuen Schlüssel generieren, wird der vorherige sofort ungültig. Dies gewährleistet eine strenge Kontrolle über Ihren Zugang ohne Abonnementstufen oder Leerlaufgebühren.

Erste Anfrage

Senden Sie Ihre erste Eingabeaufforderung an den Chat-Completion-Endpunkt, um rohen, ungefilterten Text zu erhalten. Verwenden Sie die Model-ID uncensored auf unser spezifisches Open-Weight-Modell zugreifen, das für zulässige erwachsene und kontroverse Themen optimiert ist.

Copyfrom openai import OpenAI

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

Die API akzeptiert Standardparameter wie temperature und top_p. Fehler und Ablehnungen verbrauchen keine Tokens, sodass du nur für das zahlst, was das Modell tatsächlich erreicht. Dieser Ansatz hält die Kosten im Vergleich zu Aggregatoren, die für Routing-Overhead berechnen, vorhersehbar.

Node SDK-Integration

Verwenden Sie das offizielle Node-SDK, um den JSON-Modus und das Funktionsaufrufen effizient zu verarbeiten. Legen Sie response_format zu {"type": "json_object"} für strukturierte Ausgaben oder definieren Sie Tools für Agent-ähnliches Verhalten.

Copyimport OpenAI from "openai";

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

Das Modell unterstützt Tool-Aufrufe mit tool_choice Optionen. Sie können auch ein seed für deterministische Ergebnisse. Diese Flexibilität ermöglicht es Ihnen, komplexe Anwendungen zu erstellen, ohne das OpenAI-kompatible Ökosystem zu verlassen.

Streaming-Antworten

Streamen Sie Tokens in Echtzeit über Server-Sent Events (SSE) für nutzerfreundliche Erfahrungen mit niedriger Latenz. Jeder Chunk enthält den generierten Text, und der letzte Chunk enthält die gesamten Token-Nutzungsstatistiken.

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)

Streaming reduziert die wahrgenommene Latenz für Endbenutzer. Sie können den Stream unterbrechen, wenn der Benutzer seine Meinung ändert. Die API behandelt das SSE-Protokoll automatisch, sodass auf Ihrer Seite nur wenig Code erforderlich ist.

Kontextfenster und Kapazität

Das Modell unterstützt einen 100.000-Token-Context-Window für die kombinierte Eingabe und Ausgabe. Sie können bis zu 16.000 Token pro Anfrage festlegen oder auf 2.048 Token zurückgreifen, wenn Sie max_tokens.

Dieses große Fenster ermöglicht eine umfangreiche Dokumentenanalyse oder lange Gesprächsverläufe. Halten Sie die Anfragekörper jedoch unter 8 MB. Das Modell ist kein GPT oder Llama; es ist ein eigenständiges unzensiertes KI-Modell, das für Ihren spezifischen Anwendungsfall optimiert ist.

Fehlerbehandlung und Limits

Verwalten Sie Standard-HTTP-Fehler angemessen, um einen robusten Anwendungsfluss aufrechtzuerhalten. Ein 401 Fehler deutet auf einen ungültigen oder fehlenden API-Schlüssel hin. Ein 402 Fehler bedeutet, dass Ihr bezahltes Guthaben aufgebraucht ist. Ein 429 Fehler signalisiert, dass Sie das Limit von 300 Anfragen pro Minute oder 8 gleichzeitige Anfragen überschritten haben.

Guthaben verfällt nicht, sodass Sie die Nutzung pausieren und später fortsetzen können. Fehler wie Doppelbuchungen werden über die Support-Seite behoben. Prepaid-Guthaben wird nur für den tatsächlichen Token-Verbrauch berechnet, was eine transparente Preisgestaltung für jedes Byte garantiert.