Schnellstart: Chat-Completions-API

Voraussetzungen und Base-URL

Unsere API ist mit der Standard-Schnittstelle für OpenAI-Chat-Vervollständigungen kompatibel. Sie benötigen nur eine Basis-URL und einen API-Schlüssel, um mit dem Senden von Anfragen zu beginnen. Die Basis-URL lautet HTTPS://api.howmuchisanapikey.com/v1. Dieser einzelne Endpunkt verarbeitet alle Textgenerierungen, ohne dass Sie mehrere Service-URLs oder Proxy-Konfigurationen verwalten müssen.

Die Authentifizierung ist unkompliziert. Sie müssen einen Authorization-Header mit dem Bearer-Schema gefolgt von Ihrem eindeutigen Schlüssel angeben. Jede Anfrage an den Chat-Completions-Endpunkt erfordert diesen Header, um Ihr Konto zu validieren und die Token-Nutzung gegen Ihr vorausbezahltes Guthaben zu verfolgen.

Authentifizierung und Header

Schließen Sie den Authorization-Header in jede Anfrage ein, um Ihre Identität zu überprüfen. Das Header-Format ist Authorization: Bearer YOUR_API_KEY. Wenn der Schlüssel ungültig oder abgelaufen ist, gibt die API sofort einen 401-Fehler zurück. Dies stellt sicher, dass nur autorisierte Konten Ihr Prepaid-Guthaben verbrauchen können.

Sie müssen keine zusätzlichen Header für die grundlegende Textgenerierung übergeben. Wenn Sie jedoch bestimmte Funktionen wie den JSON-Modus oder Funktionsaufrufe verwenden, müssen Sie den Content-Type-Header auf application/json setzen. Dies teilt dem Server mit, wie der Anforderungstext korrekt analysiert werden soll.

Ihre erste Chat-Vervollständigung senden

Sende eine POST-Anfrage an /v1/chat/completions mit deinem Nachrichtenverlauf und der Modellkennung. Die Modell-ID ist "uncensored". Dieses Modell ist darauf abgestimmt, ohne Ablehnungen für legale erwachsene Inhalte, Fiktion oder kontroverse Themen zu antworten. Es filtert nicht basierend auf standardpolitischen oder sozialen Normen.

Hier ist ein grundlegendes curl-Beispiel, um zu starten:

Copycurl https://api.howmuchisanapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a simple hello world function in python"}]
  }'

Die Antwort enthält den generierten Text im choices-Array. Sie können dies direkt in Ihre Anwendungslogik parsen. Jede Anfrage verbraucht Input-Tokens für Ihren Prompt und Output-Tokens für die Antwort des Modells.

Streaming-Antworten und Token-Nutzung

Verwenden Sie Server-Sent Events (SSE), um Tokens zu empfangen, sobald sie generiert werden. Dies reduziert die wahrgenommene Latenz bei langen Ausgaben. Legen Sie den Parameter stream auf true im Anforderungstext fest. Der Server sendet mehrere Chunks, die jeweils einen partiellen Delta der Antwort enthalten.

Das letzte Chunk enthält die Nutzungsdaten. Dieses Objekt enthält die gesamte Input- und Output-Token-Anzahl, die von der Anfrage verbraucht wurde. Sie können diese Daten verwenden, um Ihren lokalen Guthabenstand zu aktualisieren oder Ihre Ausgaben in Echtzeit zu überwachen. Streaming ist ideal für Chat-Schnittstellen, bei denen Nutzer sofortiges Feedback erwarten.

Function Calling und JSON-Modus

Die API unterstützt strukturierte Ausgaben über den JSON-Modus und Function Calling. Legen Sie response_format auf {"type": "json_object"} fest, um das Modell zu zwingen, gültiges JSON zurückzugeben. Dies ist nützlich zum Extrahieren von Daten oder Generieren strukturierter Konfigurationen ohne Parsing-Fehler.

Für Function Calling stellen Sie ein tools-Array in Ihrer Anfrage bereit. Das Modell antwortet mit tool_calls, wenn es feststellt, dass eine Funktion benötigt wird. Sie können dann die Funktion ausführen und das Ergebnis an das Modell zurücksenden. Dies ermöglicht komplexe Multi-Step-Workflows ohne externe Parsing-Logik.

Limits und Fehler handhaben

Sie sind auf 300 Anfragen pro Minute pro Schlüssel und 8 gleichzeitige Anfragen begrenzt. Wenn Sie diese Grenzen überschreiten, erhalten Sie einen 429 Too Many Requests-Fehler. Der Antwortkörper enthält Details zum retry-after. Passen Sie die Client-seitige Drosselung an, um unnötige Wiederholungen zu vermeiden.

Wenn Ihr Prepaid-Guthout aufgebraucht ist, gibt die API einen 402-Fehler „Payment Required“ zurück. Sie können jederzeit über Kryptowährungen nachladen. Fehler und Ablehnungen sind kostenlos, Sie zahlen also nur für erfolgreiche Token-Generierung. Der Context-Window beträgt 100,000 Tokens für Prompt und Completion zusammen.

Python

Copyfrom openai import OpenAI

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

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)