Schnellstart zur Integration der Character-API

Installieren Sie das SDK

Installieren Sie zunächst die offizielle Client-Bibliothek für Ihre Sprache. Dies gewährleistet die Kompatibilität mit dem OpenAI-kompatiblen Endpunkt, den wir bereitstellen. Die Bibliothek übernimmt für Sie die Serialisierung und Wiederholungslogik.

Für Python verwenden Sie pip. Für Node.js verwenden Sie npm. Dieser Schritt dauert nur Sekunden und richtet die Umgebung für die folgenden Codebeispiele ein.

Ihre Basis-URL konfigurieren

Richten Sie Ihren SDK-Client auf unseren Endpunkt zu, um auf das unzensierte Modell zuzugreifen. Die Basis-URL ist HTTPS://api.apicharacter.com/v1. Dies ersetzt die Standard-OpenAI-URL in Ihrer Konfiguration.

Ohne diese Änderung schlagen Anfragen fehl oder treffen den falschen Dienst. Sie müssen dies nur einmal beim Initialisieren Ihrer Client-Instanz festlegen.

Ihren API-Schlüssel festlegen

Geben Sie Ihren Schlüssel in die Umgebungsvariable oder die Client-Konfiguration ein. Die Authentifizierung ist für jede Anfrage erforderlich, um die Nutzung Ihres bezahlten Guthabens zu verfolgen. Ihr Schlüssel gewährt Zugriff auf den uncensored-LLM-Endpunkt.

Bewahren Sie diesen Wert sicher. Er fungiert als Ihr einziges Anmeldecredential für das Konto. Keine Telefonnummer oder zusätzliche Überprüfung ist für den Basiszugriff erforderlich.

Machen Sie Ihre erste Anfrage

Sende eine einfache Chat-Vervollständigung, um die Konnektivität zu überprüfen. Die Modell-ID ist "uncensored". Dies bestätigt, dass deine Authentifizierung und die Basis-URL korrekt sind, bevor du deine Anwendung erstellst.

Sehen Sie das Beispiel unten für eine Standard-cURL-Anfrage.

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

Streaming-Antworten behandeln

Aktivieren Sie Streaming für geringere Latenz in Ihren Chat-Schnittstellen. Legen Sie den Parameter „stream“ in Ihrer Anfrage auf true. Das SDK yield Tokens, sobald sie generiert werden.

Dies ist kritisch für reaktionsfähige Benutzererfahrungen. Sie verarbeiten die partiellen Chunks, wie sie über Server-Sent Events 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)

Limits, Fehler und Kontext

Verstehen Sie Ihre Einschränkungen, um Dienstunterbrechungen zu vermeiden. Sie erhalten ein Kontextfenster von 100.000 Tokens. Die maximale Ausgabe beträgt 16.000 Tokens, es sei denn, Sie geben etwas anderes an.

Das Rate-Limit beträgt 300 Anfragen pro Minute. Ein 401-Fehler bedeutet einen ungültigen Schlüssel. Ein 402-Fehler bedeutet Guthaben von null. Ein 429-Fehler bedeutet, dass Sie das Rate-Limit erreicht haben. Beachten Sie dies für die Skalierung in der Produktion.

Python

Copyfrom openai import OpenAI

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