Überblick

Für die Nutzung externer KI-Sprachmodelle im JURA KI Assistenten wird je nach Anbieter ein eigener API-Key benötigt.

Wenn ein API-Key eingetragen wurde, aber trotzdem nicht verwendet werden kann, sind häufig Zuordnung, Gültigkeit, Berechtigung oder Abrechnung beim jeweiligen KI-Anbieter zu prüfen.

Die nachfolgenden Hinweise helfen dabei, typische Ursachen einzugrenzen.

 

Hintergrund

Ein API-Key ist ein Zugangsschlüssel zu einem bestimmten KI-Anbieter. Er berechtigt den JURA KI Assistenten dazu, Anfragen an den jeweiligen Anbieter zu senden.

Wichtig ist: Ein API-Key gilt immer nur für den Anbieter, bei dem er erstellt wurde. Ein API-Key von OpenAI kann beispielsweise nicht für Anthropic Claude, Google Gemini, Mistral oder Perplexity verwendet werden.

• Für ein OpenAI-Modell wird ein OpenAI API-Key benötigt.
• Für ein Anthropic-Claude-Modell wird ein Anthropic API-Key benötigt.
• Für ein Google-Gemini-Modell wird ein Google API-Key benötigt.
• Für ein Mistral-Modell wird ein Mistral API-Key benötigt.
• Für ein Perplexity-Modell wird ein Perplexity API-Key benötigt.

 

Mögliche Ursachen

API-Key wurde unvollständig oder fehlerhaft eingetragen

Ein API-Key muss vollständig und unverändert übernommen werden. Bereits ein fehlendes Zeichen, ein zusätzliches Leerzeichen oder ein Zeilenumbruch kann dazu führen, dass der Schlüssel nicht erkannt wird.

Bitte prüfen Sie insbesondere:

• Wurde der API-Key vollständig kopiert?
• Befinden sich am Anfang oder Ende Leerzeichen?
• Wurde versehentlich ein Zeilenumbruch mitkopiert?
• Wurde der API-Key in das Feld des richtigen Anbieters eingetragen?
• Wurde die Eingabe nach dem Eintragen gespeichert?

Am besten wird der API-Key direkt aus dem Anbieterportal kopiert und anschließend im JURA KI Assistenten neu eingetragen.

 

API-Key wurde gelöscht, deaktiviert oder neu erzeugt

API-Keys können im Konto des jeweiligen KI-Anbieters gelöscht, deaktiviert oder durch neue Schlüssel ersetzt werden.

Ein API-Key kann dann nicht mehr genutzt werden, auch wenn er im JURA KI Assistenten noch eingetragen ist.

Bitte prüfen Sie im Anbieterportal:

• Ist der API-Key noch vorhanden?
• Ist der API-Key aktiv?
• Wurde der API-Key zwischenzeitlich gelöscht oder ersetzt?
• Wurde ein neuer API-Key erzeugt, aber noch nicht im JURA KI Assistenten eingetragen?

Wenn ein API-Key beim Anbieter nicht mehr angezeigt wird, kann er in der Regel nicht wiederhergestellt werden. In diesem Fall muss ein neuer API-Key erstellt und im JURA KI Assistenten eingetragen werden.

 

Abrechnung, Guthaben oder Zahlungsmethode fehlen

Viele KI-Anbieter setzen für die API-Nutzung ein aktives Abrechnungskonto voraus. Auch wenn ein API-Key technisch vorhanden ist, kann die Nutzung blockiert werden, wenn beim Anbieter keine gültige Zahlungsmethode hinterlegt ist oder kein ausreichendes Guthaben zur Verfügung steht.

Bitte prüfen Sie im Anbieterportal:

• Ist die API-Nutzung für das Konto aktiviert?
• Ist eine gültige Zahlungsmethode hinterlegt?
• Ist ausreichend Guthaben vorhanden?
• Wurde ein Kostenlimit erreicht?
• Gibt es offene Abrechnungs- oder Kontohinweise des Anbieters?
• Bei Google: Wurde das Rechnungskonto auf Vorauszahlung (Prepay) umgestellt und ist ausreichend Guthaben vorhanden?

Ein Abonnement der Chat-Anwendungen der KI-Anbieter (z. B. ChatGPT Plus, Claude Pro oder Google AI Pro) reicht hierfür nicht aus, da API-Nutzung und Chat-Abonnement getrennte Dienste sind.

 

Modell ist für den API-Key nicht freigeschaltet

Nicht jeder API-Key berechtigt automatisch zur Nutzung jedes Modells eines Anbieters.

Je nach Anbieter, Konto, Projekt, Organisation oder Tarif kann es Einschränkungen geben. In diesem Fall ist der API-Key zwar grundsätzlich gültig, kann aber für das ausgewählte Modell nicht verwendet werden.

Bitte prüfen Sie im Anbieterportal:

• Ist das ausgewählte Modell für das Konto freigeschaltet?
• Gehört der API-Key zum richtigen Projekt oder zur richtigen Organisation?
• Sind im Anbieterportal Modell-, Projekt- oder Rollenberechtigungen eingeschränkt?
• Wird das ausgewählte Modell vom Anbieter aktuell für API-Zugriffe unterstützt?

Wenn ein anderes Modell desselben Anbieters funktioniert, spricht dies häufig für eine modellbezogene Einschränkung.

 

Google: Gemini API im Projekt nicht aktiviert

Bei Google wird ein API-Key auch dann als ungültig erkannt, wenn die Gemini API im zugehörigen Google-Cloud-Projekt nicht aktiviert ist oder der API-Key nicht für die Gemini API freigegeben wurde – selbst wenn der Schlüssel korrekt kopiert wurde.

Bitte prüfen Sie in der Google Cloud Console (https://console.cloud.google.com):

• Ist unter APIs und Dienste > Aktivierte APIs und Dienste die Gemini API für das Projekt aktiviert?
• Ist beim API-Schlüssel unter API-Einschränkungen die Gemini API ausgewählt?
• Gehört der API-Schlüssel zu dem Projekt, in dem die Gemini API aktiviert ist?

 

Kontingent, Rate-Limit oder Nutzungslimit erreicht

KI-Anbieter können Anfragen begrenzen. Das kann je nach Anbieter, Tarif oder Konto durch Kontingente, Minutenlimits, Tageslimits, Monatslimits oder Rate-Limits erfolgen.

Typische Hinweise sind Meldungen zu:

• quota
• rate limit
• insufficient quota
• billing
• credits
• usage limit
• access denied

In diesem Fall sollte im Anbieterportal geprüft werden, ob ein Nutzungslimit erreicht wurde oder ob weitere API-Nutzung freigeschaltet werden muss.

Weitere Hinweise dazu finden Sie im Beitrag:

Was sind API-Fehler und was kann ich selbst tun?

 

Verbindung zum KI-Anbieter wird blockiert

Wenn API-Key, Modell und Abrechnung korrekt eingerichtet sind, kann eine blockierte Verbindung zum KI-Anbieter die Nutzung verhindern.

In Kanzlei- und Unternehmensumgebungen sollten daher Firewall, Proxy, Webfilter oder Endpoint-Security geprüft werden.

Besonders relevant sind:

• ausgehende HTTPS-Verbindungen zum jeweiligen KI-Anbieter
• Proxy-Einstellungen
• HTTPS-/SSL-Inspection
• Webfilter-Regeln
• blockierte API-Domains
• Sicherheitssoftware auf Client, Terminalserver oder Netzwerkebene

Weitere Hinweise dazu finden Sie im Beitrag:

Welche Firewall- und Antivirus-Ausnahmen benötigt der JURA KI Assistent?

 

API-Key im JURA KI Assistenten erneut speichern

Wenn der API-Key im Anbieterportal gültig ist, kann er im JURA KI Assistenten erneut eingetragen und gespeichert werden.

Gehen Sie dazu wie folgt vor:

1. Öffnen Sie im JURA KI Assistenten die Einstellungen.
2. Wechseln Sie zu Allgemein.
3. Tragen Sie den API-Key beim passenden Anbieter ein.
4. Achten Sie darauf, dass keine zusätzlichen Leerzeichen enthalten sind.
5. Speichern Sie die Einstellungen. Ihr API-Key wird dabei automatisch geprüft.
6. Wählen Sie anschließend ein Modell desselben Anbieters aus und testen Sie die Anfrage erneut.

 

Typische Ursachen im Überblick

Häufige Ursachen für einen nicht nutzbaren API-Key sind:

• Der API-Key gehört zu einem anderen Anbieter als das ausgewählte Modell.
• Der API-Key wurde unvollständig kopiert.
• Der API-Key enthält zusätzliche Leerzeichen oder Zeilenumbrüche.
• Der API-Key wurde beim Anbieter gelöscht oder deaktiviert.
• Es fehlt eine gültige Zahlungsmethode oder ausreichendes Guthaben.
• Ein Kosten-, Nutzungs- oder Rate-Limit wurde erreicht.
• Das ausgewählte Modell ist für den API-Key nicht freigeschaltet.
• Bei Google ist die Gemini API im Projekt nicht aktiviert oder der Schlüssel nicht für die Gemini API freigegeben.
• Der API-Key gehört zum falschen Projekt oder zur falschen Organisation.
• Firewall, Proxy oder Sicherheitssoftware blockieren die Verbindung zum Anbieter.

 

Weiterführende Anleitungen

Weitere Informationen finden Sie hier:

API-Keys erstellen
https://ki-lab.dictanet.com/downloads/Schritt-für-Schritt-Anleitung-API-Keys-erstellen.pdf

Zusätzlich hilfreich sind folgende FAQ-Beiträge:

Wie erstelle ich einen API-Key?

Ich habe meinen API-Key verloren - was kann ich tun?

Warum erhalte ich die Meldung „Es ist ein API-Key notwendig“?

Was sind API-Fehler und was kann ich selbst tun?

Benötige ich ein Abonnement wie ChatGPT Plus, Claude Pro oder Google AI Pro?