Fehler 401: was tun, wenn grok-4.20-0309-reasoning fehlschlägt

Ein 401 bedeutet, dass die Authentifizierung fehlgeschlagen ist: Die Anfrage enthält keinen API-Key, oder der Key ist ungültig, gelöscht oder abgelaufen.

401 Unauthorized bedeutet, dass die Anfrage keine gültigen Zugangsdaten enthält. Das Gateway konnte den Aufrufer nicht identifizieren, daher erreicht die Anfrage das Upstream-Modell nie. Die Prüfung von Authorization-Header und Key-Status ist der einzige Weg.

grok-4.20-0309-reasoning wird von xAI bereitgestellt. Alles auf dieser Seite — Ursachen, Lösungen und gemessene Daten — basiert auf dem tatsächlichen Laufzeitverhalten dieses Modells auf der Gatewayschicht.

An diesem Gateway ist die häufigste Ursache: Der Authorization-Header fehlt. Empfohlene erste Maßnahme: Senden Sie den Header als Authorization: Bearer gefolgt von Ihrem Key.

Häufige Ursachen

  • Der Authorization-Header fehlt
  • Der Key ist falsch geschrieben oder enthält Leerzeichen
  • Der Key wurde auf der Tokens-Seite gelöscht oder deaktiviert
  • Versehentlich wurde ein Key einer anderen Plattform verwendet

So beheben Sie es

  • Senden Sie den Header als Authorization: Bearer gefolgt von Ihrem Key
  • Erzeugen Sie auf der Tokens-Seite einen neuen Key
  • Prüfen Sie, dass Sie keinen Key eines anderen Dienstes verwenden
  • Verifizieren Sie den Key mit einer minimalen curl-Anfrage

Wiederholung mit exponentiellem Backoff

Der folgende Code wiederholt den Aufruf, wenn grok-4.20-0309-reasoning 401 liefert: bis zu 5 Versuche, mit wachsender Wartezeit und zufälligem Jitter, damit parallele Anfragen nicht gleichzeitig wiederholen. Base-URL und API-Key werden aus Umgebungsvariablen gelesen — nicht hart codieren.

import os, time, random
import requests

BASE  = os.getenv("OPENAI_BASE_URL")   # e.g. https://<your-gateway>/v1
KEY   = os.getenv("OPENAI_API_KEY")
MODEL = 'grok-4.20-0309-reasoning'


def chat(messages, retries=5):
    """Retry with exponential backoff + jitter."""
    for i in range(retries):
        try:
            r = requests.post(
                BASE + "/chat/completions",
                headers={"Authorization": "Bearer " + KEY},
                json={"model": MODEL, "messages": messages, "stream": True},
                timeout=60,
            )
            if r.status_code == 429 or r.status_code >= 500:
                time.sleep(min(2 ** i + random.uniform(0, 1), 30))
                continue
            r.raise_for_status()
            return r.json()
        except requests.exceptions.Timeout:
            time.sleep(min(2 ** i + random.uniform(0, 1), 30))
    raise RuntimeError("gave up after " + str(retries) + " retries")


print(chat([{"role": "user", "content": "hello"}]))

Wichtige Daten zu diesem Modell

API-Endpunkthttps://api.airai.cc/v1
OpenAI-kompatibelOpenAI-compatible
AnbieterxAI
Kontext1M
FunktionenReasoning, Tools, Files, Vision
API-Formateopenai, openai-response, openai-response-compact, anthropic, gemini, openai-alpha-search
Abrechnungsformelp * 1.25 + cr * 0.2 + c * 2.5) : tier("200k_plus", p * 2.5 + cr * 0.4 + c * 5

Häufige Fragen

Zählen fehlgeschlagene Anfragen zum Rate-Limit-Kontingent?

Keine Berechnung: Nur tatsächlich erzeugter Output zählt zum Verbrauch. Der Eingabepreis liegt bei etwa $1.25 pro Million Tokens. Bei der Abrechnung p * 1.25 + cr * 0.2 + c * 2.5) : tier("200k_plus", p * 2.5 + cr * 0.4 + c * 5 werden fehlgeschlagene Anfragen nicht angerechnet. Prüfen Sie zuerst Guthaben und Rate-Limits in der Konsole, dann den Code. Wenn Sie Kosten nach p * 1.25 + cr * 0.2 + c * 2.5) : tier("200k_plus", p * 2.5 + cr * 0.4 + c * 5 schätzen, rechnen Sie das Retry-Budget mit ein.

Wie nutze ich den Retry-After-Header in der Antwort?

Business-Code muss meist nicht geändert werden, nur der Aufruftakt. Bei der Abrechnung p * 1.25 + cr * 0.2 + c * 2.5) : tier("200k_plus", p * 2.5 + cr * 0.4 + c * 5 werden fehlgeschlagene Anfragen nicht angerechnet. Setzen Sie die Obergrenze auf 3–5 Versuche und ergänzen Sie Jitter. Wiederholbare Fehler mit exponentiellem Backoff, der Rest sofort als Fehler zurückgeben.

Erholt sich 401 von selbst oder ist Eingreifen nötig?

Dieser Fehler hängt nicht mit der Modellfähigkeit zusammen, er liegt auf Gateway-Ebene. Meist ist es ein kurzzeitiges Problem, das von selbst verschwindet. Die Fähigkeits-Tags dieses Modells sind Reasoning, Tools, Files, Vision. Besteht der Fehler mehrere Minuten, kontaktieren Sie den Plattform-Support zum Upstream-Status.

Was sollte ich loggen, wenn 401 häufig auftritt?

Gruppieren Sie die Fehler nach Zeit und Knoten; das Muster ist meist deutlich. Das Modell wird von xAI bereitgestellt, der Upstream-Status richtet sich nach den Ankündigungen des Anbieters. Reproduzieren Sie es zuerst in der Testumgebung mit demselben Request-Body.

Weitere Fehler bei diesem Modell

Andere Modelle mit demselben Fehler

Zurück zur Modellseite

Daten aktualisiert: 2026-10-10 18:35

Technischer SupportLive-Support
Nach oben