Problem: Das Zusatzmodul „Künstliche Intelligenz (KI / OpenAI)“ funktioniert nicht
Wenn bei der Nutzung der OpenAI-API Probleme auftreten, helfen Ihnen die folgenden Prüfschritte dabei, die Ursache schnell zu identifizieren und zu beheben.
Schritte zur Fehleranalyse
Schritt 1: API-Token überprüfen
Prüfen Sie, ob der API-Token korrekt eingetragen und noch gültig ist. Ein abgelaufener oder fehlerhaft kopierter Token führt sofort zu Verbindungsfehlern.
Schritt 2: Billing und Bezahlplan prüfen
Melden Sie sich in Ihrem OpenAI-Konto an und prüfen Sie, ob ein aktiver Tarif oder ausreichendes Guthaben vorhanden ist. Ohne aktiven Bezahlplan blockiert OpenAI alle API-Anfragen.
⚠️ Hinweis: Jeder API-Aufruf verursacht Kosten. Die API lässt sich nur nutzen, wenn im OpenAI-Konto gültige Zahlungsinformationen hinterlegt sind.
Schritt 3: Prompts kontrollieren
Stellen Sie sicher, dass alle benötigten Prompts vollständig und korrekt hinterlegt sind. Fehlende oder leere Prompts können dazu führen, dass venabo keine gültige Anfrage an die API sendet.
Schritt 4: Fehlermeldungen analysieren
Zeigt venabo eine Fehlermeldung an? Lesen Sie diese sorgfältig – sie enthält oft einen direkten Hinweis auf die Ursache. Ein typisches Beispiel bei fehlendem Guthaben:
For more information on this error, read the docs: https://platform.openai.com/docs/guides/error-codes/api-errors.
💡 Tipp: Diese Fehlermeldung bedeutet, dass Ihr OpenAI-Guthaben aufgebraucht ist oder kein aktiver Bezahlplan hinterlegt wurde. Melden Sie sich unter platform.openai.com/account/billing an und prüfen Sie Ihre Zahlungsangaben.
Schritt 5: Logs im Portal einsehen
Öffnen Sie im venabo-Portal den Log-Bereich. Dort finden Sie detaillierte Einträge zu fehlgeschlagenen API-Aufrufen, die weitere Hinweise auf die Fehlerursache liefern.
Praxisbeispiel
Szenario: Die KI-Funktion hat mehrere Wochen einwandfrei funktioniert, gibt jetzt aber plötzlich einen Fehler aus.
| Prüfschritt | Befund | Maßnahme |
|---|---|---|
| API-Token | Token ist korrekt eingetragen | Kein Handlungsbedarf |
| Billing | Guthaben aufgebraucht | Guthaben im OpenAI-Konto aufladen |
| Prompts | Vollständig hinterlegt | Kein Handlungsbedarf |
| Fehlermeldung | „You exceeded your current quota“ | Bestätigt: Guthaben fehlt |
| Ergebnis | Nach Guthabenaufladung funktioniert die KI-Funktion wieder einwandfrei. | |
Häufige Fragen
Warum funktioniert die KI-Funktion nach dem Eintragen des API-Tokens nicht?
Ein gültiger Token allein reicht nicht aus. Im OpenAI-Konto muss zusätzlich ein aktiver Bezahlplan mit hinterlegter Zahlungsmethode oder ausreichendem Guthaben vorhanden sein. Prüfen Sie beides unter platform.openai.com/account/billing.
Wie hoch sind die Kosten pro API-Aufruf?
Die Kosten hängen vom genutzten OpenAI-Modell und der Länge der verarbeiteten Texte ab. Eine aktuelle Preisübersicht finden Sie direkt bei OpenAI unter openai.com/pricing. venabo selbst erhebt keine zusätzlichen Gebühren für API-Aufrufe.
Wo finde ich die Logs in venabo?
Navigieren Sie im venabo-Portal zum Bereich „Logs“ oder „Protokoll“. Dort listet venabo alle API-Aufrufe mit Zeitstempel und Fehlerstatus auf. So erkennen Sie schnell, ob ein Problem regelmäßig oder nur sporadisch auftritt.
Was tue ich, wenn keiner der Prüfschritte den Fehler erklärt?
Wenden Sie sich an den venabo-Support und senden Sie die vollständige Fehlermeldung sowie die relevanten Log-Einträge mit. So kann das Support-Team die Ursache schnell eingrenzen.
Zusammenfassung
| Prüfschritt | Was wird geprüft? | Häufige Ursache |
|---|---|---|
| 1. API-Token | Korrektheit und Gültigkeit | Token abgelaufen oder fehlerhaft eingetragen |
| 2. Billing | Aktiver Tarif / Guthaben | Guthaben aufgebraucht, kein Bezahlplan aktiv |
| 3. Prompts | Vollständigkeit der Konfiguration | Prompt fehlt oder ist leer |
| 4. Fehlermeldung | Systemausgabe analysieren | Quota-Fehler, Authentifizierungsfehler |
| 5. Logs | Detaillierte Protokolleinträge | Wiederkehrende Fehler identifizieren |