Schnellstart: Integrieren Sie apertus ai chat

Voraussetzungen und Einrichtung

Beginnen Sie damit, ein Konto zu erstellen und Ihren API-Schlüssel zu erhalten. Melden Sie sich auf der Seite zur Schlüsselgenerierung mit Google oder einem E-Mail-Passwort an. Das System zeigt Ihren Schlüssel sofort an, sodass Sie ihn ohne Verzögerung kopieren können. Für die Registrierung ist keine Telefonnummer erforderlich. Sie erhalten $0.50 Testguthaben, das sieben Tage gültig ist, sodass Sie die Konnektivität testen können, ohne Geld einzuzahlen.

Konfigurieren Sie Ihre Umgebungsvariable oder Ihren SDK-Client, um auf die korrekte Basis-URL zu verweisen. Diese URL funktioniert mit Standard OpenAI-Bibliotheken. Ändern Sie nur die Basis-URL und Ihren Schlüssel. Die Modell-ID ist "uncensored". Dieser einzelne Endpunkt verarbeitet alle Textvervollständigungen. Sie müssen kein Routing verwalten oder verschiedene Modelle auswählen.

Stellen Sie sicher, dass Ihre Client-Bibliothek das OpenAI Chat Completions-Protokoll unterstützt. Die meisten modernen SDKs funktionieren out of the box. Überprüfen Sie, ob Ihr Netzwerk ausgehende HTTPS-Anfragen zulässt. Der Dienst akzeptiert Standard-JSON-Payloads. Neben der Authentifizierung sind keine speziellen Header erforderlich.

Authentifizierung mit API-Schlüsseln

Übergeben Sie Ihren API-Schlüssel im Authorization-Header für jede Anfrage. Verwenden Sie das Bearer-Schema gefolgt von Ihrer Schlüsselsequenz. Der Dienst validiert den Schlüssel gegen Ihr Konto. Ungültige Schlüssel führen zu einem 401 Unauthorized-Fehler. Abgelaufene Schlüssel oder unzureichende Guthaben lösen eine 402 Payment Required-Antwort aus. Prüfen Sie Ihr Guthaben im Dashboard, wenn Anfragen fehlschlagen.

Halten Sie Ihren Schlüssel sicher. Jedes Konto hält jeweils nur einen aktiven Schlüssel. Generieren Sie einen neuen Schlüssel, um den alten zu ersetzen. Teilen Sie Ihren Schlüssel nicht in öffentlichen Repositories. Der API-Schlüssel ist der einzige Bezeichner für Ihre Nutzung. Rate-Limits gelten pro Schlüssel, nicht pro Konto.

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

Die Authentifizierung ist zustandslos. Der Server überprüft das Token bei jedem Aufruf. Wenn Sie Ihren Schlüssel rotieren, aktualisieren Sie alle laufenden Clients sofort. Das Fehlen des Headers führt zu einer sofortigen Ablehnung. Die Fehlermeldung gibt den Authentifizierungsfehler deutlich an.

Senden Ihrer ersten Anfrage

Senden Sie eine POST-Anfrage an den Chat-Vervollständigungs-Endpunkt. Fügen Sie die Modell-ID „uncensored“ und Ihren Nachrichtenverlauf ein. Die API gibt eine Textantwort zurück. Sie können die Ausgabe streamen oder auf die vollständige Vervollständigung warten. Jede Anfrage verbraucht Eingabe- und Ausgabetokens. Fehler kosten keine Credits. Ablehnungen sind kostenlos.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apertusaichat.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 Antwort enthält Nutzungsstatistiken. Verfolgen Sie den Token-Verbrauch, um Ihr Prepaid-Guthaben zu verwalten. Das Modell antwortet ohne Inhaltsablehnungen für die legale Erwachsenenverwendung. Sie können System-Prompts senden, um das Verhalten zu definieren. Benutzernachrichten steuern das Gespräch. Der Kontextfenster unterstützt insgesamt 100,000 Tokens.

Starten Sie mit einem einfachen Zwei-Nachrichten-Austausch. Dies überprüft die Konnektivität und die Antwortqualität. Passen Sie Temperatur und top_p für kreative oder präzise Ausgaben an. Die API unterstützt Standardparameter. Stop-Sequenzen funktionieren wie erwartet. Seed-Werte stellen reproduzierbare Ergebnisse sicher.

Streaming-Antworten über SSE

Aktivieren Sie das Streaming, indem Sie den Parameter „stream“ auf true setzen. Die API gibt Server-Sent Events (SSE) anstelle eines einzelnen JSON-Objekts zurück. Jeder Chunk enthält einen Teil des generierten Texts. Lesen Sie die Chunks, bis der Stream endet. Der letzte Chunk enthält die gesamte Token-Nutzung.

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. Nutzer sehen Text in Echtzeit erscheinen. Dies ist ideal für Chat-Schnittstellen. Behandeln Sie Partial-Tokens sorgfältig. Verketteten Sie Chunks, um die vollständige Antwort zu bilden. Der Server schließt die Verbindung, wenn die Generierung abgeschlossen ist.

Überwachen Sie Stream-Fehler. Netzwerkunterbrechungen können den Stream abbrechen. Implementieren Sie bei Bedarf eine Wiederverbindungslogik. Die API sendet den Verlauf nicht erneut. Starten Sie eine neue Anfrage, wenn der Stream fehlschlägt. Token-Anzahlen im letzten Chunk spiegeln die gesamte Generierung wider.

Parameter und Modi handhaben

Verwenden Sie Standardparameter zur Steuerung der Generierung. Legen Sie Temperatur für Zufälligkeit fest. Passen Sie top_p für Nucleus-Sampling an. Definieren Sie Stop-Sequenzen, um die Generierung frühzeitig zu beenden. Übergeben Sie einen Seed für deterministische Ausgaben. Aktivieren Sie den JSON-Modus, indem Sie response_format auf json_object setzen. Das Modell gibt gültiges JSON zurück, wenn angefordert.

Function Calling wird unterstützt. Definieren Sie Tools in der Anfrage. Das Modell gibt bei Bedarf Tool-Aufrufe zurück. Parsen Sie die Tool-Argumente in Ihrem Code. Übergeben Sie die Ergebnisse zurück, um das Gespräch fortzusetzen. Dies ermöglicht komplexe Agent-Workflows.

Copyimport OpenAI from "openai";

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

Max Tokens begrenzt die Ausgabelänge. Der Standardwert beträgt 2.048 Tokens. Legen Sie bei Bedarf einen höheren Wert fest. Das harte Limit pro Anfrage beträgt 16.000 Tokens. Das Kontextfenster beträgt 100.000 Tokens. Planen Sie die Länge des Verlaufs entsprechend. Frequency- und Presence-Penalties helfen, Wiederholungen zu reduzieren.

Verständnis von Limits und Fehlern

Ratenbegrenzungen schützen die Dienststabilität. Du kannst 300 Anfragen pro Minute senden. Die Parallelität ist auf acht gleichzeitige Anfragen pro Schlüssel begrenzt. Anfragekörper dürfen 8 MB nicht überschreiten. Das Überschreiten der Grenzen führt zu einem 429-Fehler „Too Many Errors“. Warte vor dem Wiederholen.

Prüfen Sie die Fehlercodes zur Diagnose. 401 bedeutet ungültiger oder fehlender Schlüssel. 402 zeigt unzureichendes Guthaben an. Laden Sie per Krypto auf, um den Dienst fortzusetzen. 429 signalisiert Rate-Limiting. 400 kennzeichnet eine ungültige Anfrage. Überprüfen Sie die Fehlermeldung für Details.

Das Management des Kontextfensters ist entscheidend. Addieren Sie Prompt- und Completion-Tokens. Bleiben Sie deutlich unter 100.000 Tokens. Kürzen Sie alte Nachrichten bei Bedarf. Die API kürzt nicht automatisch. Sie steuern die Historienlänge. Effiziente Kontextnutzung senkt die Kosten.