OneMux/Dokumentation/Häufig gestellte Fragen

Häufig gestellte Fragen

Tritt bei einem API-Aufruf ein Fehler auf? Finde das Problem schnell anhand des Statuscodes. Diese Seite listet die häufigsten Fehlercodes und Lösungen auf. Die meisten Probleme lassen sich innerhalb von 1 Minute selbst beheben.

Schnelle Fehlerdiagnose

Wenn ein Fehler auftritt, ermittle zuerst den HTTP-Statuscode (z. B. 401 oder 429) und orientiere dich anschließend an der entsprechenden Lösung:

StatuscodeUrsacheLösung
401API Key ungültigFormat (sk-xxx) und Gültigkeit des Schlüssels überprüfen
402Unzureichendes GuthabenGuthaben in der Konsole aufladen
404Modell-ID falschDie richtige ID von der Modellseite kopieren
429Zu viele AnfragenFrequenz reduzieren und nach 10 Sekunden erneut versuchen
500Fehler beim Upstream-DienstSpäter erneut versuchen oder das Modell wechseln

401 - API Key ungültig

Häufigste Ursachen:

  • Beim Kopieren wurden zusätzliche Leerzeichen eingefügt
  • Falsches Format (beginnt nicht mit sk-)
  • Der Schlüssel wurde gelöscht

Schnelle Lösung:

# ✅ Richtiges Format
api_key = "sk-1234567890abcdef"

# ❌ Häufige Fehler
api_key = " sk-1234567890abcdef "  # Leerzeichen am Anfang und Ende
api_key = "1234567890abcdef"       # Präfix sk- fehlt

Öffne die Konsole, um den Schlüssel erneut zu kopieren oder einen neuen Schlüssel zu erstellen.

402 - Unzureichendes Guthaben

Das Kontoguthaben reicht nicht aus, um diese Anfrage zu bezahlen.

Öffne das Abrechnungscenter, um Guthaben aufzuladen.

Hinweis: Bei Anfragen mit langem Kontext (z. B. wenn Gemini 1 Million tokens verarbeitet) wird der maximal mögliche Betrag vorab reserviert. Stelle sicher, dass ausreichend Guthaben vorhanden ist.

404 - Modell nicht vorhanden

Häufige Ursachen:

  • Schreibfehler in der Modell-ID
  • Ein veralteter Modellname wird verwendet (z. B. wurde gpt-4o durch gpt-6.1-sol ersetzt)
  • Falscher Base-URL-Pfad

Lösung:

Die richtige Modell-ID abrufen

  1. 1

    Modellseite aufrufen

    Öffne https://onemux.net/models

  2. 2

    Benötigtes Modell finden

    Suche nach dem gewünschten Modell oder durchsuche die Liste

  3. 3

    Modell-ID kopieren

    Klicke auf die Kopierschaltfläche oder kopiere die vollständige ID manuell

Stelle sicher, dass die Base URL https://api.onemux.net/v1 lautet (beachte das abschließende /v1).

429 - Zu viele Anfragen

Innerhalb kurzer Zeit wurden zu viele Anfragen gesendet, wodurch die Frequenzbegrenzung ausgelöst wurde.

Lösung:

  • Anfragerate reduzieren
  • 10-30 Sekunden warten und es erneut versuchen
  • Eine automatische Wiederholungslogik hinzufügen (siehe Dokumentation zur Fehlerbehandlung)
  • Anzahl der parallelen Aufgaben reduzieren

500/502/503 - Dienstausfall

Der Upstream-Mod以ellservice ist vorübergehend nicht verfügbar.

Lösung:

  • 10-30 Sekunden warten und es erneut versuchen
  • Zu einem anderen Modell wechseln
  • Die Statusseite aufrufen, um den Servicestatus zu überprüfen

Reihenfolge der Fehlerdiagnose bei unklaren Problemen

Schrittweise Fehlerdiagnose

  1. 1

    Guthaben überprüfen

    In der Konsole anmelden und prüfen, ob ausreichend Guthaben vorhanden ist

  2. 2

    API Key überprüfen

    Den vollständigen Schlüssel erneut kopieren und sicherstellen, dass keine Leerzeichen enthalten sind

  3. 3

    Modell-ID überprüfen

    Die ID erneut von der Modellseite kopieren

  4. 4

    Base URL überprüfen

    Sicherstellen, dass sie https://api.onemux.net/v1 lautet

  5. 5

    Software neu starten

    Konfiguration speichern und den Client neu starten