Uncensored API-Integrationsleitfaden

Authentifizierung & Basis-URL

Richten Sie Ihr OpenAI-kompatibles SDK auf den dedizierten Endpunkt ein. Unsere Infrastruktur verwendet eine einzelne Basis-URL für alle Anfragen, sodass Sie nur mit dem uncensored-Modell interagieren, ohne an einen Anbieter gebunden zu sein. Sie müssen Ihren API-Schlüssel im Authorization header für jeden Aufruf. Dieser Schlüssel wird sofort generiert, wenn Sie sich über Google oder E-Mail anmelden. Es fallen keine monatlichen Gebühren an, um den Zugriff aufrechtzuerhalten, und der Schlüssel bleibt gültig, bis Ihr bezahltes Guthaben aufgebraucht ist. Fehler bei der Authentifizierung, wie ein ungültiger Schlüssel, geben einen 401-Statuscode zurück. Ablehnungen für rechtliche erwachsene Inhalte sind kostenlos, aber Sie zahlen nur für die tatsächliche Token-Nutzung.

Copycurl https://api.unsecureapikeys.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the three main dependencies for this python script"}]
  }'

Chat-Vervollständigungs-Endpunkt

Senden Sie Textdaten an das POST /v1/chat/completions Endpunkt zum Empfangen generierter Antworten. Dies ist die primäre Schnittstelle für Ihre Integrationen und unterstützt einen Kontextfenster von 100,000 Token sowohl für Prompt als auch für Completion. Die Modell-ID, die Sie in Ihrer Payload angeben müssen, ist immer uncensored. Sie müssen sich keine Sorgen über komplexes Modell-Routing oder Versionierung machen, da wir ein einzelnes Open-Weight-Modell anbieten, das für unzensierte Ausgaben optimiert ist. Wenn Sie das 8-MB-Limit für den Anforderungstextkörper überschreiten, gibt die API einen Fehler zurück. Sie können auch verfügbare Modelle über GET /v1/models Verbindungsüberprüfung vor der Hauptarbeit durchführen.

Streaming-Antworten

Aktivieren Sie die Echtzeit-Token-Generierung, indem Sie stream: true in Ihrem Anfrage-Payload festlegen. Die API gibt Server-Sent Events (SSE) für die Anzeige mit geringer Latenz in Ihren Anwendungen zurück. Token-Nutzungsstatistiken erscheinen im letzten Chunk des Streams, sodass Sie die Kosten genau verfolgen können. Diese Methode ist ideal für Chatbots oder interaktive Schnittstellen, bei denen Benutzer sofortiges Feedback erwarten. Beachten Sie, dass die maximale Ausgabe pro Anfrage bis zu den vollen 100,000 Token umfasst; max_tokens ist optional. Streaming funktioniert nahtlos mit Standard-OpenAI-SDKs, wenn die base_url korrekt aktualisiert wird.

Copyfrom openai import OpenAI

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

Funktionsaufruf & JSON-Modus

Integrieren Sie strukturierte Datenausgaben über den JSON-Modus oder die Function-Calling-Funktionen. Legen Sie response_format zu {"type": "json_object"} um konsistente JSON-Ausgaben für Ihre Parser zu erzwingen. Sie können auch Tools definieren und tool_choice für komplexe Agenten-Workflows. Das unzensierte Modell unterstützt diese Funktionen ohne die üblichen starren Guardrails, die oft Funtion-Schemas bei anderen Anbietern brechen. Dies macht es zuverlässig für automatisierte Pipelines, die präzise Datenextraktion erfordern. Stellen Sie sicher, dass Ihre Tool-Definitionen gültig sind, um Parsing-Fehler auf der Client-Seite zu vermeiden.

Copyimport OpenAI from "openai";

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

Parameter & Limits

Steuern Sie das Generierungsverhalten mit Standardparametern wie temperature, top_p, stop, und seed. Durch die Anpassung dieser Parameter lässt sich das Verhältnis von Kreativität zu Determinismus in Ihren Ausgaben feinjustieren. Sie sind auf 300 Anfragen pro Minute pro Schlüssel begrenzt, mit einer Parallelität von 8 gleichzeitigen Anfragen. Pro Konto ist nur ein aktiver Schlüssel erlaubt; die Generierung eines neuen ersetzt den alten. Das Prepaid-Guthabenmodell bedeutet, dass Sie $0.15 pro 1M Eingabetokens und $0.50 pro 1M Ausgabetokens bezahlen. Fehler verbrauchen kein Guthaben, sodass Sie nur für erfolgreiche Abschlüsse bezahlen.

Fehlerbehandlung

Behandeln Sie gängige API-Antworten korrekt, um die Stabilität der Anwendung zu gewährleisten. Ein 401-Fehler weist auf einen ungültigen oder abgelaufenen API-Schlüssel hin. Ein 402-Fehler bedeutet, dass Ihr vorausbezahltes Guthaben nicht ausreicht, was einen Nachladeprozess über Kryptowährungen erfordert. Rate Limits lösen eine 429-Antwort aus, wenn Sie 300 Anfragen pro Minute überschreiten. Die API gibt keine Embeddings oder Bilddaten zurück, daher kann die Anforderung dieser Formate zu Fehlern führen. Prüfen Sie immer den Statuscode, bevor Sie den JSON-Body analysieren. Kontextfenster-Begrenzungen sind streng, überwachen Sie also die Token-Anzahl, um ein Abschneiden bei langen Gesprächen zu vermeiden.

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)