Zum Inhalt springen

KI-Assistent-API-Key besorgen: Unterschied zwischen den Versionen

Aus VermCAD Hilfe Wiki
Neue Seite: eigenen API-Key fuer den KI-Assistenten besorgen und eintragen (Anleitung je Anbieter, Eintragen im Dialog KI-Dienste, Sicherheitshinweise)
 
Nutzungsstufen OpenAI auf das Stufenmodell vom 06.10.2026 umgestellt (Build/Launch/Grow nach gekauften Credits, keine Wartezeit); Querverweis, Fehlertabelle und Prüfdatum nachgezogen
 
(Eine dazwischenliegende Version desselben Benutzers wird nicht angezeigt)
Zeile 86: Zeile 86:
# Erzeugen Sie einen neuen Key (''Create new secret key'') und geben Sie ihm einen wiedererkennbaren Namen.
# Erzeugen Sie einen neuen Key (''Create new secret key'') und geben Sie ihm einen wiedererkennbaren Namen.
# Kopieren Sie den Key sofort. Er beginnt mit <code>sk-</code> und wird nur ein einziges Mal vollständig angezeigt.
# Kopieren Sie den Key sofort. Er beginnt mit <code>sk-</code> und wird nur ein einziges Mal vollständig angezeigt.
Bei OpenAI gilt zusätzlich: Das Anfrage-Limit des Kontos hängt an der Nutzungsstufe, und die richtet sich nach den insgesamt gekauften Credits. Ist das Limit zu niedrig, scheitert schon die erste Frage – siehe [[#Guthaben ist nicht gleich Anfrage-Limit (Nutzungsstufen)|Guthaben ist nicht gleich Anfrage-Limit]].


== Google Gemini ==
== Google Gemini ==
Zeile 115: Zeile 117:
Schlägt die Prüfung fehl, meldet VermCad das mit dem Text des Anbieters. Der Key bleibt trotzdem gespeichert und lässt sich jederzeit erneut eintragen oder löschen.
Schlägt die Prüfung fehl, meldet VermCad das mit dem Text des Anbieters. Der Key bleibt trotzdem gespeichert und lässt sich jederzeit erneut eintragen oder löschen.


{{Hilfe:Hinweis|Die Prüfung beantwortet nur die Frage, ob der Anbieter den Key kennt und akzeptiert. Sie prüft '''nicht''', ob auf dem Konto Guthaben liegt. Ein Key ohne Guthaben besteht die Prüfung und scheitert erst bei der ersten Frage im Chat.}}
{{Hilfe:Hinweis|Die Prüfung beantwortet nur die Frage, ob der Anbieter den Key kennt und akzeptiert. Sie prüft '''nicht''', ob auf dem Konto Guthaben liegt und wie hoch das [[#Guthaben ist nicht gleich Anfrage-Limit (Nutzungsstufen)|Anfrage-Limit]] ist. Ein Key ohne Guthaben besteht die Prüfung und scheitert erst bei der ersten Frage im Chat.}}


== Dienst und Modell auswählen ==
== Dienst und Modell auswählen ==
Zeile 135: Zeile 137:
* Die US-Dollar-Beträge sind grobe Schätzungen aus den gezählten Token und erscheinen nur für Modelle mit hinterlegtem Preis.
* Die US-Dollar-Beträge sind grobe Schätzungen aus den gezählten Token und erscheinen nur für Modelle mit hinterlegtem Preis.
* Ein '''Restguthaben lässt sich über die Schnittstelle nicht abfragen'''. Verbrauch und Abrechnung sehen Sie ausschließlich im Portal des Anbieters, also dort, wo Sie den Key erzeugt haben.
* Ein '''Restguthaben lässt sich über die Schnittstelle nicht abfragen'''. Verbrauch und Abrechnung sehen Sie ausschließlich im Portal des Anbieters, also dort, wo Sie den Key erzeugt haben.
== Guthaben ist nicht gleich Anfrage-Limit (Nutzungsstufen) ==
Guthaben und Anfrage-Limit sind '''zwei verschiedene Dinge''':
* Das '''Guthaben''' ist das Geld, das auf dem Konto ausgegeben werden kann.
* Das '''Anfrage-Limit''' ist eine technische Geschwindigkeitsgrenze, gemessen in ''Token pro Minute'' (TPM). Es gilt je Konto '''und je Modell'''.
Ein Konto kann also Guthaben haben und trotzdem mit dem Fehler '''429''' („rate limit … tokens per min") abbrechen, wenn sein Limit zu niedrig ist. VermCad schickt mit jeder Frage viel Kontext mit – die Anweisungen an die KI, das Inhaltsverzeichnis dieses Hilfe-Wikis, die Beschreibung der Werkzeuge und je nach Frage Teile des Projekts. Eine einzelne Anfrage kann damit über einem niedrigen Limit liegen, und dann hilft auch Warten nicht.
Das Limit hängt an der '''Nutzungsstufe''' (''Usage Tier'') des Kontos. Bei OpenAI richtet sich die Stufe seit Oktober 2026 allein nach den '''insgesamt gekauften Credits''' – eine Wartezeit gibt es nicht mehr. Beim Erreichen einer Schwelle stuft OpenAI automatisch hoch; auf der Limits-Seite gibt es dafür außerdem den Knopf ''Upgrade tier''.
{| class="wikitable"
! Nutzungsstufe
! insgesamt gekaufte Credits
! Token pro Minute laut OpenAI-Doku
|-
| Build
| ab 5 $
| 1 Mio.
|-
| Launch
| ab 100 $
| 4 Mio.
|-
| Grow
| ab 500 $
| 40 Mio.
|}
''Angaben von OpenAI, Stand 10/2026; die Token-Werte gelten für die gängigen Modellfamilien, einzelne Modelle weichen ab. Bis September 2026 galten fünf Stufen mit Wartezeiten. Schwellen und Limits können sich ändern – maßgeblich ist immer die Anzeige im Portal des Anbieters.''
Ohne gekaufte Credits (Stufe ''Free'') nennt die OpenAI-Doku keine Token-Werte; mit dem ersten Kauf ab 5 $ beginnt die Stufe ''Build''. Die eigene Stufe und die tatsächlich geltenden Limits stehen unter ''platform.openai.com → Settings → Organization → Limits''. Reicht das Limit nicht aus, gibt es drei Wege:
* '''Die nächste Stufe erreichen''' – bei OpenAI durch den Kauf von Credits bis zur Schwelle oder über ''Upgrade tier''. Für Limits über der höchsten Stufe hilft der Support des Anbieters.
* '''Ein kleineres Modell wählen.''' Die Limits gelten je Modell, und kleinere Modelle haben oft ein höheres Limit.
* '''Vorerst einen anderen KI-Dienst einstellen''' – siehe [[#Dienst und Modell auswählen|Dienst und Modell auswählen]]. Der VermCad-Testzugang steht ebenfalls jederzeit zur Verfügung.
{{Hilfe:Hinweis|Guthaben nachzuladen hebt das Limit nur an, wenn damit die nächste Nutzungsstufe erreicht wird. Zubuchbare Kapazität unabhängig von der Stufe gibt es bei OpenAI nur im ''Scale Tier'' für Großkunden.}}
Denselben Kurzhinweis zeigt der Dialog ''KI-Assistent: Dienste und Engine'' in der Gruppe ''API-Keys der KI-Dienste''; ausführlicher steht er dort im Hinweisfenster (Tooltip) zu ''OpenAI (GPT)''.


== Sicherheitshinweise ==
== Sicherheitshinweise ==
Zeile 155: Zeile 197:
| Prüfung in Ordnung, aber jede Frage scheitert
| Prüfung in Ordnung, aber jede Frage scheitert
| Auf dem Konto beim Anbieter liegt kein Guthaben, oder das eingetragene Modell ist für dieses Konto nicht freigeschaltet.
| Auf dem Konto beim Anbieter liegt kein Guthaben, oder das eingetragene Modell ist für dieses Konto nicht freigeschaltet.
|-
| Meldung „rate limit" bzw. Fehler 429
| Das Anfrage-Limit des Kontos reicht für diese Frage nicht aus. Es hängt an der Nutzungsstufe des Kontos, nicht am verbleibenden Guthaben – siehe [[#Guthaben ist nicht gleich Anfrage-Limit (Nutzungsstufen)|Nutzungsstufen]].
|-
|-
| Das eingetragene Modell wird nicht gefunden
| Das eingetragene Modell wird nicht gefunden
Zeile 162: Zeile 207:
| Sie sind nicht als [[Optionen Menü-Das Dialogfenster Hauptnutzer|Hauptnutzer]] angemeldet.
| Sie sind nicht als [[Optionen Menü-Das Dialogfenster Hauptnutzer|Hauptnutzer]] angemeldet.
|}
|}
''Die genannten Portal-Adressen und Konditionen der Anbieter wurden zuletzt am 31.08.2026 geprüft. Anbieter ändern ihre Portale gelegentlich; im Zweifel hilft die Suche nach „API key" auf der Webseite des jeweiligen Dienstes.''
''Die genannten Portal-Adressen und Konditionen der Anbieter wurden zuletzt am 31.08.2026 geprüft, die Nutzungsstufen von OpenAI am 20.10.2026. Anbieter ändern ihre Portale gelegentlich; im Zweifel hilft die Suche nach „API key" auf der Webseite des jeweiligen Dienstes.''


{{Hilfe:NachOben}}
{{Hilfe:NachOben}}
[[Kategorie:FAQ]]
[[Kategorie:FAQ]]

Aktuelle Version vom 20. Oktober 2026, 09:00 Uhr

Der VermCad KI-Assistent beantwortet Fragen zur Bedienung von VermCad im Klartext und stützt sich dabei zuerst auf dieses Hilfe-Wiki. Sie öffnen ihn über das Menü Hilfe → AI Chat; ist im selben Menü KI-Hilfe bei F1 angehakt, öffnet ihn außerdem die Taste F1 mit dem passenden Kontext des gerade offenen Dialogs.

Der Assistent ist sofort einsatzbereit – ohne Anmeldung, ohne Einrichtung und ohne Kosten. Wer möchte, kann stattdessen einen eigenen API-Key eines KI-Anbieters hinterlegen. Diese Seite beschreibt, wozu das gut ist, wie Sie an einen solchen Key kommen und wie Sie ihn in VermCad eintragen.

Brauche ich überhaupt einen eigenen API-Key?

Nein. Ohne eigenen Key läuft der Assistent über den kostenlosen VermCad-Testzugang. Ein eigener Key ist ein Angebot für Büros, die den Assistenten breiter einsetzen oder einen bestimmten KI-Dienst bevorzugen. Der Testzugang ist in der täglichen Nutzungsmenge begrenzt; ein eigener Key hebt diese Grenze auf.

ohne eigenen Key (VermCad-Testzugang) mit eigenem API-Key
Kosten keine Die Nutzung des Assistenten bleibt kostenlos. Berechnet wird nur, was der KI-Anbieter für den eigenen Key in Rechnung stellt – direkt an das Büro. VermCad rechnet nichts ab und ist an dieser Abrechnung nicht beteiligt.
KI-Dienst und Modell fest vorgegeben (Anthropic Claude mit einem von VermCad gewählten Modell) frei wählbar unter allen Diensten, für die ein Key hinterlegt ist; das Modell ist frei eintragbar
Nutzungsmenge täglich begrenzt von VermCad nicht begrenzt; es gilt, was der Anbieter für Ihren Key vorsieht
Themen nur Fragen mit Bezug zu VermCad, Vermessung, ALKIS, Geodäsie oder CAD keine Themenbeschränkung
Hilfe-Wiki wird für jede Frage zuerst durchsucht wird ebenfalls zuerst durchsucht
Einrichtung keine einmalig durch den Hauptnutzer; der Key gilt danach büroweit

Ein hinterlegter Key wirkt für alle Nutzer des Büros, denn er wird in den globalen Vorgaben gespeichert. Welcher Dienst tatsächlich benutzt wird, entscheidet aber jeder Nutzer für sich – siehe Dienst und Modell auswählen.

Welchen Dienst soll ich nehmen?

Für den einfachsten Einstieg empfiehlt sich Google Gemini: Ein Google-Konto genügt, es gibt eine kostenlose Stufe, und Zahlungsdaten sind dafür nicht nötig. Bei Anthropic und OpenAI muss dagegen zuerst Guthaben eingezahlt werden, bevor der Key funktioniert.

KI-Dienst Key-Seite des Anbieters Voraussetzung Key beginnt mit
Anthropic Claude console.anthropic.com Konto und aufgeladenes Guthaben sk-ant-
OpenAI (GPT) platform.openai.com Konto und aufgeladenes Guthaben sk-
Google Gemini aistudio.google.com Google-Konto; kostenlose Stufe vorhanden AIza
Mistral AI console.mistral.ai Konto; kostenlose Experimentierstufe vorhanden kein festes Kennzeichen

Hinweis: Sie brauchen nur den Dienst, den Sie wirklich einsetzen wollen. Es ist nicht nötig, bei allen vier Anbietern ein Konto anzulegen.

Anthropic Claude

  1. Öffnen Sie console.anthropic.com/settings/keys und melden Sie sich an oder legen Sie ein Konto an.
  2. Laden Sie unter Billing Guthaben auf. Ohne Guthaben nimmt der Dienst zwar den Key an, beantwortet aber keine Frage.
  3. Erzeugen Sie unter API Keys einen neuen Key und geben Sie ihm einen wiedererkennbaren Namen, zum Beispiel VermCad.
  4. Kopieren Sie den Key sofort in die Zwischenablage. Er beginnt mit sk-ant- und wird nur ein einziges Mal vollständig angezeigt.

OpenAI (GPT)

  1. Öffnen Sie platform.openai.com/api-keys und melden Sie sich an oder legen Sie ein Konto an.
  2. Laden Sie unter Billing Guthaben auf; ohne Guthaben liefert der Dienst keine Antworten.
  3. Erzeugen Sie einen neuen Key (Create new secret key) und geben Sie ihm einen wiedererkennbaren Namen.
  4. Kopieren Sie den Key sofort. Er beginnt mit sk- und wird nur ein einziges Mal vollständig angezeigt.

Bei OpenAI gilt zusätzlich: Das Anfrage-Limit des Kontos hängt an der Nutzungsstufe, und die richtet sich nach den insgesamt gekauften Credits. Ist das Limit zu niedrig, scheitert schon die erste Frage – siehe Guthaben ist nicht gleich Anfrage-Limit.

Google Gemini

Der schnellste Weg zu einem eigenen Key – hier genügt ein Google-Konto.

  1. Öffnen Sie aistudio.google.com/apikey (Google AI Studio) und melden Sie sich mit Ihrem Google-Konto an.
  2. Bestätigen Sie die Nutzungsbedingungen, falls Sie AI Studio zum ersten Mal öffnen.
  3. Erzeugen Sie einen Key (API-Schlüssel erstellen). In der kostenlosen Stufe sind dafür keine Zahlungsdaten nötig.
  4. Kopieren Sie den Key. Er beginnt mit AIza.

Mistral AI

  1. Öffnen Sie console.mistral.ai/api-keys und melden Sie sich an oder legen Sie ein Konto an.
  2. Wählen Sie den gewünschten Tarif. Für erste Versuche gibt es eine kostenlose Stufe.
  3. Erzeugen Sie einen neuen Key und geben Sie ihm einen wiedererkennbaren Namen.
  4. Kopieren Sie den Key. Ein festes Kennzeichen am Anfang gibt es hier nicht.

Den API-Key in VermCad eintragen

Das Eintragen ist dem Hauptnutzer vorbehalten. Alle anderen Nutzer sehen im Dialog, dass ein Key hinterlegt ist, können ihn aber weder ändern noch löschen.

  1. Öffnen Sie den KI-Assistenten (Menü Hilfe → AI Chat).
  2. Klicken Sie unten rechts im Chatfenster auf das Zahnrad ⚙. Es öffnet sich der Dialog KI-Assistent: Dienste und Engine.
  3. In der Gruppe API-Keys der KI-Dienste steht je Dienst eine Zeile. Der Knopf Key-Seite führt direkt zur Key-Verwaltung des jeweiligen Anbieters im Browser.
  4. Klicken Sie in der Zeile des gewünschten Dienstes auf Eintragen, fügen Sie den kopierten Key ein und bestätigen Sie mit OK.
  5. VermCad speichert den Key sofort und büroweit und prüft ihn anschließend beim Anbieter. Nach wenigen Sekunden steht hinter dem maskierten Key ✓ gültig.

Schlägt die Prüfung fehl, meldet VermCad das mit dem Text des Anbieters. Der Key bleibt trotzdem gespeichert und lässt sich jederzeit erneut eintragen oder löschen.

Hinweis: Die Prüfung beantwortet nur die Frage, ob der Anbieter den Key kennt und akzeptiert. Sie prüft nicht, ob auf dem Konto Guthaben liegt und wie hoch das Anfrage-Limit ist. Ein Key ohne Guthaben besteht die Prüfung und scheitert erst bei der ersten Frage im Chat.

Dienst und Modell auswählen

Der Key gilt büroweit, die Auswahl des Dienstes dagegen gilt nur für den angemeldeten Nutzer. Jeder Nutzer stellt sie im selben Dialog ein:

  1. Zahnrad ⚙ im Chatfenster öffnen.
  2. In der Gruppe Meine Engine-Auswahl unter KI-Dienst den gewünschten Dienst wählen. Zur Auswahl stehen der Eintrag VermCad-Testzugang und alle Dienste, für die ein Key hinterlegt ist.
  3. Unter Modell das gewünschte Modell wählen. Das Feld ist frei beschreibbar, damit auch neue Modellnamen ohne VermCad-Update genutzt werden können. Der Knopf Modelle abrufen holt die aktuell verfügbaren Modelle direkt beim Anbieter.
  4. Mit OK bestätigen. Die nächste Frage im Chat läuft über den gewählten Dienst.

Wird der Key eines gewählten Dienstes später gelöscht, fällt der Assistent stillschweigend auf den VermCad-Testzugang zurück – er bleibt also in jedem Fall benutzbar.

Verbrauch und Guthaben

Der Dialog zeigt in der Gruppe Verbrauch die verbrauchten Token der laufenden Sitzung, die eigene Gesamtsumme und die Summe aller Nutzer des Büros. Diese Anzeige ist eine reine Information:

  • Durch die Nutzung des Assistenten entstehen keine Kosten – außer denen, die der KI-Anbieter für einen selbst hinterlegten Key berechnet.
  • Die US-Dollar-Beträge sind grobe Schätzungen aus den gezählten Token und erscheinen nur für Modelle mit hinterlegtem Preis.
  • Ein Restguthaben lässt sich über die Schnittstelle nicht abfragen. Verbrauch und Abrechnung sehen Sie ausschließlich im Portal des Anbieters, also dort, wo Sie den Key erzeugt haben.

Guthaben ist nicht gleich Anfrage-Limit (Nutzungsstufen)

Guthaben und Anfrage-Limit sind zwei verschiedene Dinge:

  • Das Guthaben ist das Geld, das auf dem Konto ausgegeben werden kann.
  • Das Anfrage-Limit ist eine technische Geschwindigkeitsgrenze, gemessen in Token pro Minute (TPM). Es gilt je Konto und je Modell.

Ein Konto kann also Guthaben haben und trotzdem mit dem Fehler 429 („rate limit … tokens per min") abbrechen, wenn sein Limit zu niedrig ist. VermCad schickt mit jeder Frage viel Kontext mit – die Anweisungen an die KI, das Inhaltsverzeichnis dieses Hilfe-Wikis, die Beschreibung der Werkzeuge und je nach Frage Teile des Projekts. Eine einzelne Anfrage kann damit über einem niedrigen Limit liegen, und dann hilft auch Warten nicht.

Das Limit hängt an der Nutzungsstufe (Usage Tier) des Kontos. Bei OpenAI richtet sich die Stufe seit Oktober 2026 allein nach den insgesamt gekauften Credits – eine Wartezeit gibt es nicht mehr. Beim Erreichen einer Schwelle stuft OpenAI automatisch hoch; auf der Limits-Seite gibt es dafür außerdem den Knopf Upgrade tier.

Nutzungsstufe insgesamt gekaufte Credits Token pro Minute laut OpenAI-Doku
Build ab 5 $ 1 Mio.
Launch ab 100 $ 4 Mio.
Grow ab 500 $ 40 Mio.

Angaben von OpenAI, Stand 10/2026; die Token-Werte gelten für die gängigen Modellfamilien, einzelne Modelle weichen ab. Bis September 2026 galten fünf Stufen mit Wartezeiten. Schwellen und Limits können sich ändern – maßgeblich ist immer die Anzeige im Portal des Anbieters.

Ohne gekaufte Credits (Stufe Free) nennt die OpenAI-Doku keine Token-Werte; mit dem ersten Kauf ab 5 $ beginnt die Stufe Build. Die eigene Stufe und die tatsächlich geltenden Limits stehen unter platform.openai.com → Settings → Organization → Limits. Reicht das Limit nicht aus, gibt es drei Wege:

  • Die nächste Stufe erreichen – bei OpenAI durch den Kauf von Credits bis zur Schwelle oder über Upgrade tier. Für Limits über der höchsten Stufe hilft der Support des Anbieters.
  • Ein kleineres Modell wählen. Die Limits gelten je Modell, und kleinere Modelle haben oft ein höheres Limit.
  • Vorerst einen anderen KI-Dienst einstellen – siehe Dienst und Modell auswählen. Der VermCad-Testzugang steht ebenfalls jederzeit zur Verfügung.

Hinweis: Guthaben nachzuladen hebt das Limit nur an, wenn damit die nächste Nutzungsstufe erreicht wird. Zubuchbare Kapazität unabhängig von der Stufe gibt es bei OpenAI nur im Scale Tier für Großkunden.

Denselben Kurzhinweis zeigt der Dialog KI-Assistent: Dienste und Engine in der Gruppe API-Keys der KI-Dienste; ausführlicher steht er dort im Hinweisfenster (Tooltip) zu OpenAI (GPT).

Sicherheitshinweise

  • Behandeln Sie einen API-Key wie ein Passwort. Wer ihn hat, kann auf Rechnung Ihres Kontos Anfragen stellen.
  • Geben Sie den Key nicht per E-Mail, Chat oder Bildschirmfoto weiter und legen Sie ihn nicht in Projektdaten ab.
  • VermCad zeigt einen hinterlegten Key nur maskiert an – sichtbar sind lediglich die ersten und letzten Zeichen. Aus dem Dialog lässt er sich nicht wieder auslesen.
  • Der Knopf Löschen entfernt den Key nach einer Rückfrage sofort und büroweit. Danach arbeiten alle Nutzer dieses Dienstes wieder über den VermCad-Testzugang.
  • Ist ein Key versehentlich nach außen gelangt, widerrufen Sie ihn im Portal des Anbieters (Revoke bzw. Löschen) und tragen Sie in VermCad einen neu erzeugten Key ein.

Wenn der Key nicht angenommen wird

Beobachtung mögliche Ursache
Meldung, dass die Prüfung fehlgeschlagen ist Der Key ist unvollständig kopiert, wurde beim Anbieter bereits widerrufen oder gehört zu einem anderen Dienst.
Prüfung in Ordnung, aber jede Frage scheitert Auf dem Konto beim Anbieter liegt kein Guthaben, oder das eingetragene Modell ist für dieses Konto nicht freigeschaltet.
Meldung „rate limit" bzw. Fehler 429 Das Anfrage-Limit des Kontos reicht für diese Frage nicht aus. Es hängt an der Nutzungsstufe des Kontos, nicht am verbleibenden Guthaben – siehe Nutzungsstufen.
Das eingetragene Modell wird nicht gefunden Modellnamen ändern sich häufig. Holen Sie die Liste mit Modelle abrufen und wählen Sie einen Eintrag daraus.
Die Knöpfe Eintragen und Löschen sind grau Sie sind nicht als Hauptnutzer angemeldet.

Die genannten Portal-Adressen und Konditionen der Anbieter wurden zuletzt am 31.08.2026 geprüft, die Nutzungsstufen von OpenAI am 20.10.2026. Anbieter ändern ihre Portale gelegentlich; im Zweifel hilft die Suche nach „API key" auf der Webseite des jeweiligen Dienstes.



[Nach oben]