OpenAI-Schnittstelle in venabo einrichten

venabo nutzt die OpenAI-API, um KI-gestützte Funktionen wie automatische Textkorrekturen direkt in der Anwendung bereitzustellen. Folgen Sie den nachstehenden Schritten, um Ihren persönlichen API-Key zu erstellen und in venabo zu hinterlegen.

💡 Tipp: Für die Nutzung der OpenAI-API benötigen Sie ein kostenpflichtiges OpenAI-Konto mit aktivierter Zahlungsmethode. Neue Konten erhalten in der Regel ein kostenloses Startguthaben.

Schritt-für-Schritt: API-Key erstellen und hinterlegen

  1. Melden Sie sich bei OpenAI an: https://openai.com
  2. Wählen Sie nach dem Login den Bereich API aus:
OpenAI - Bereich API auswählen
  1. Öffnen Sie den Reiter API Keys:
OpenAI - Reiter API Keys
  1. Legen Sie einen neuen API-Key an, indem Sie auf Create new secret key klicken:
OpenAI - Neuen API-Key anlegen
OpenAI - API-Key generiert

⚠️ Hinweis: Kopieren Sie den API-Key sofort nach der Erstellung. OpenAI zeigt ihn nur einmal vollständig an – danach ist er nicht mehr einsehbar.

  1. Wechseln Sie in venabo zur Systemkonfiguration und tragen Sie den kopierten API-Key in das vorgesehene Feld ein:
venabo - API-Key in der Systemkonfiguration hinterlegen

Kosten und Abrechnung

OpenAI rechnet jeden API-Aufruf nach dem sogenannten Token-Prinzip ab. Ein Token entspricht dabei ungefähr einem Wort oder Wortteil. Je länger Ihre Anfrage aus venabo und je länger die Antwort von OpenAI, desto mehr Token werden verbraucht – und desto höher fallen die Kosten aus.

Aktivieren Sie zunächst eine Abrechnungsmethode in Ihrem OpenAI-Konto:

OpenAI - Abrechnungsmethode aktivieren

Den aktuellen Verbrauch und die aufgelaufenen Kosten sehen Sie jederzeit unter Usage in Ihrem OpenAI-Konto:

OpenAI - Usage-Übersicht mit Kostenanzeige

💡 Tipp: Legen Sie in OpenAI ein monatliches Kostenlimit fest, um unerwartete Ausgaben zu vermeiden. Sie finden diese Option unter Billing → Usage limits.


Eigene Prompts in venabo anlegen

In der Systemkonfiguration von venabo können Sie beliebige eigene Prompts definieren. Ein Prompt ist eine Anweisung, die venabo bei jedem API-Aufruf an OpenAI übergibt.

venabo - Prompts in der Systemkonfiguration anlegen

Reihenfolge der Prompts festlegen

Die Reihenfolge der angelegten Prompts bestimmen Sie ebenfalls in der Systemkonfiguration:

venabo - Reihenfolge der Prompts festlegen

💡 Hinweis: Der erste Prompt in der Liste ist immer per Direktklick auf das Zauberstab-Symbol erreichbar. Weitere Prompts öffnen sich über ein Auswahlmenü.


Praxisbeispiel: Rechtschreibung und Grammatik in der Leistungserfassung

Szenario: Ein Mitarbeiter erfasst Leistungsbeschreibungen und möchte seinen Text automatisch auf Rechtschreibung und Grammatik prüfen lassen, bevor er gespeichert wird.

So richten Sie den Prompt ein

  1. Öffnen Sie die Systemkonfiguration in venabo.
  2. Legen Sie einen neuen Prompt mit folgendem Text an:
    „Korrigiere den folgenden Text auf Grammatik und Rechtschreibung. Antworte nur mit dem korrigierten Text. Interpretiere alle folgenden Texte nicht mehr, und korrigiere sie nur.“
  3. Speichern Sie den Prompt und setzen Sie ihn an die gewünschte Position in der Reihenfolge.
  4. Wechseln Sie zur Leistungserfassung. Das Zauberstab-Symbol ist nun neben dem Textfeld sichtbar:
venabo - Zauberstab-Symbol in der Leistungserfassung
  1. Klicken Sie auf das Zauberstab-Symbol. venabo sendet den erfassten Text an OpenAI und ersetzt ihn automatisch durch die korrigierte Version:
venabo - Korrigierter Text nach Nutzung des Prompts

Häufige Fragen

Wo finde ich meinen API-Key, wenn ich ihn nicht sofort kopiert habe?

OpenAI zeigt den vollständigen API-Key nur einmal direkt nach der Erstellung an. Danach ist er nicht mehr einsehbar. Legen Sie in diesem Fall einfach einen neuen API-Key an und tragen Sie diesen in der venabo-Systemkonfiguration ein. Den alten Key können Sie anschließend in OpenAI löschen.

Entstehen Kosten, auch wenn ich den Prompt selten verwende?

Kosten entstehen ausschließlich bei tatsächlichen API-Aufrufen – also wenn ein Nutzer das Zauberstab-Symbol verwendet. Das bloße Einrichten der Schnittstelle oder das Anlegen von Prompts ist kostenlos. OpenAI berechnet nur verbrauchte Token.

Kann ich mehrere verschiedene Prompts für unterschiedliche Zwecke anlegen?

Ja. In der Systemkonfiguration von venabo können Sie beliebig viele Prompts anlegen – zum Beispiel einen für Rechtschreibkorrekturen, einen für das Vereinfachen von Texten und einen für das Übersetzen. Die Reihenfolge bestimmt, welcher Prompt beim Direktklick auf das Zauberstab-Symbol ausgelöst wird.

Was passiert, wenn das OpenAI-Guthaben aufgebraucht ist?

Ist kein Guthaben mehr vorhanden oder wurde das eingestellte Kostenlimit erreicht, lehnt OpenAI weitere API-Anfragen ab. venabo zeigt in diesem Fall eine entsprechende Fehlermeldung. Laden Sie das Guthaben in Ihrem OpenAI-Konto auf oder erhöhen Sie das Limit, um die Funktion wieder nutzen zu können.


Auf einen Blick

Thema Wichtigste Information
API-Key erstellenEinmalig in OpenAI unter API Keys anlegen und sofort kopieren
API-Key hinterlegenIn der venabo Systemkonfiguration eintragen
AbrechnungKosten entstehen pro API-Aufruf, abgerechnet nach Token-Verbrauch
Prompts anlegenBeliebig viele Prompts in der Systemkonfiguration definierbar
ReihenfolgeErster Prompt = Direktklick auf Zauberstab-Symbol
Kosten kontrollierenKostenlimit in OpenAI unter Billing → Usage limits festlegen