Reseller/Endnutzer-ID und Limits

Endnutzer-ID

Wenn ein Konto oder ein API-Key viele deiner eigenen Endnutzer bedient, sende bei jeder Anfrage den Header X-End-User-Id, der angibt, zu welchem Endnutzer sie gehört. Verstößt ein Endnutzer wiederholt gegen die Regeln, schränkt Wokey nur diesen Endnutzer ein, deine übrigen Nutzer arbeiten normal weiter, und eine Benachrichtigung in der App sagt dir, um wen es geht.

Auf dieser Seiteexpand_more

Header sendenlink

cURL
curl https://api.wokey.ai/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "X-End-User-Id: u_3f8a2c1e9b7d" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 1024,
    "messages": [
      { "role": "user", "content": "Hello" }
    ]
  }'
  • Der Wert ist deine eigene Endnutzer-ID: 1 bis 128 sichtbare ASCII-Zeichen (Buchstaben, Ziffern und Symbole; keine Leerzeichen oder Nicht-ASCII-Zeichen). Nutze eine UUID, eine interne ID oder deren Hash, nie eine E-Mail-Adresse, Telefonnummer oder andere personenbezogene Daten. Der Wert, den du bereits als safety_identifier (OpenAI) oder metadata.user_id (Anthropic) sendest, funktioniert unverändert. Für nicht angemeldete Nutzer sende eine Sitzungs-ID oder lass den Header weg; ein fester Wert wie anonymous oder guest macht aus vielen Personen einen einzigen Endnutzer, der gemeinsam eingeschränkt wird.
  • Chat Completions, Responses und Messages akzeptieren ihn. Der Header ist nur für Wokey bestimmt und wird nie an den Upstream weitergegeben. Mit einem SDK setzt du ihn für den ganzen Client über default_headers (Python) oder defaultHeaders (Node.js) oder pro Anfrage über extra_headers.

Einschränkungenlink

  • Die Regeln entsprechen den Einschränkungen auf Kontoebene, gelten aber nur für diesen einen Endnutzer: Wiederholte Verstöße eines Endnutzers bei einem Modell innerhalb kurzer Zeit führen zuerst zu einem Rate-Limit für ihn bei diesem Modell (1 gleichzeitige Anfrage, 10 Anfragen pro Minute); bei weiteren Verstößen wird das Modell für den Endnutzer 24 Stunden pausiert und danach automatisch wieder freigegeben; mehrere pausierte Modelle innerhalb von 30 Tagen pausieren alle Modellaufrufe des Endnutzers, bis der Support sie wieder freigibt.
  • Anfragen über dem Rate-Limit eines Endnutzers liefern HTTP 429 rate_limit_exceeded, Anfragen eines pausierten Endnutzers HTTP 403 request_blocked. Beide erreichen den Upstream nicht und werden nicht berechnet. Wird ein Endnutzer pausiert, erhältst du eine Benachrichtigung in der App mit Endnutzer-ID, Modell und dem Zeitpunkt der Freigabe; Benachrichtigungen innerhalb einer Stunde werden zu einer zusammengefasst.
  • Der Header lockert nie die Limits deines Kontos: Verstöße zählen mit oder ohne ihn für dein Konto, nach den Einschränkungen auf Kontoebene. Anfragen eines pausierten Endnutzers erreichen den Upstream nicht mehr und zählen daher nicht länger für dein Konto. Für Anfragen, die tatsächlich einen Verstoß auslösen, fällt wie üblich die Bearbeitungsgebühr für Verstöße an.

Gebühren und Einschränkungen bei Verstößen →

In der Konsole verwaltenlink

Unternehmens- und Reseller-Konten können eingeschränkte Endnutzer und deren Ablehnungsgründe der letzten 7 Tage im Tab „Endnutzer“ der API-Konsole einsehen und ein Rate-Limit oder eine Pause selbst aufheben. Das geht für jeden Endnutzer einmal alle 24 Stunden; für einen Endnutzer, der bei allen Modellen pausiert ist, brauchst du weiterhin den Support. Kontaktiere den Support, um den Tab freizuschalten.

Ungültige Wertelink

Ein ungültiger Wert (zu lang, mit Leerzeichen oder Nicht-ASCII-Zeichen, oder der Header zweimal in einer Anfrage) wird so behandelt, als fehle der Header: Die Anfrage läuft normal durch, und jeder API-Key erhält eine Erinnerung pro Tag in der App.