> For the complete documentation index, see [llms.txt](https://docs.pixeleyes.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pixeleyes.de/anleitungen-instructions/deutsch/dokumentation-unserer-shopware-6-plugins/log-wachter-mit-ki-analyse-und-ticket-workflow/api-schlussel-und-budget.md).

# Api Schlüssel und Budget

Die KI-Analyse ist optional und wird nur auf Knopfdruck genutzt. Dafür brauchen Sie einen **API-Schlüssel** des gewählten Anbieters. Der API-Zugang wird **separat vom ChatGPT-/Claude-Abo** abgerechnet (Pay-as-you-go bzw. Prepaid-Guthaben).

{% hint style="warning" %}
**Wichtig:** Behandeln Sie jeden Schlüssel wie ein Passwort. Nicht weitergeben, nicht in Screenshots/Tickets teilen. Legen Sie immer ein **Ausgaben-Limit** an, bevor Sie die KI aktiv nutzen.
{% endhint %}

***

## OpenAI (ChatGPT) – Schlüssel anlegen

Der Schlüssel kommt **nicht** aus der ChatGPT-App, sondern aus der Developer-Plattform.

{% stepper %}
{% step %}

### Developer-Plattform öffnen

Öffnen Sie **<https://platform.openai.com>** und melden Sie sich an (oder registrieren Sie sich).
{% endstep %}

{% step %}

### Zahlungsmethode & Guthaben einrichten

Öffnen Sie: Organisation → **Settings → Billing → Overview**.

* **Add payment details** – Zahlungsmethode hinterlegen.
* Ein kleines **Guthaben** kaufen (Minimum meist $5, z. B. $10). Ohne Guthaben funktioniert die API nicht.
* Bei „Business address": deutsche GmbH → **DE VAT** (USt-IdNr., Format `DE` + 9 Ziffern) wählen.
  {% endstep %}

{% step %}

### Schlüssel erstellen

Öffnen Sie **<https://platform.openai.com/api-keys>** → **Create new secret key**, vergeben Sie einen Namen (z. B. „PixelLogGuard") und bestätigen Sie.
{% endstep %}

{% step %}

### Schlüssel kopieren

Kopieren Sie den Schlüssel (`sk-…`) **sofort** – er wird **nur einmal** angezeigt.
{% endstep %}
{% endstepper %}

### OpenAI – Ausgaben-Limit einstellen

#### a) Spend-Limit (weiches Monatslimit)

Öffnen Sie: Settings → **Billing → Usage limits** (bzw. „Set monthly budgets").

* **Organization spend limit** über **Edit spend limit** auf einen kleinen Betrag setzen, z. B. **$20**. Ist er erreicht, blockiert OpenAI weitere Anfragen.
* **Spend alerts** hinzufügen, etwa Warn-Mails bei 50 % / 80 %.

{% hint style="info" %}
Hinweis: „Actual costs may exceed this" – das Limit ist weich; laufende Anfragen können es minimal überschreiten.
{% endhint %}

#### b) Guthaben/Auto-Reload (harte Grenze)

Beim Kauf im Dialog „Configure payment":

* **Auto-reload AUS** = härteste Grenze: Es wird nur Ihr gekauftes Guthaben verbraucht, danach stoppt die API.
* Oder **Auto-reload AN** + **„Monthly reload limit"** einschalten und niedrig setzen (z. B. $20), damit das automatische Nachladen pro Monat gedeckelt ist.

{% hint style="success" %}
**Empfehlung:** Auto-Reload aus + kleines Guthaben (z. B. $10) + Spend-Limit $20. Für den Log-Wächter reicht das sehr lange (nur Cent-Beträge je Analyse).
{% endhint %}

### OpenAI – Rate-Limits (nur zur Info)

Unter **Limits** finden Sie zusätzlich **Rate-Limits** (TPM/RPM/RPD) und **Usage Tiers**. Das ist das **Tempo**, kein Geldbetrag. Für den Log-Wächter reichen selbst die niedrigsten Tier-Limits, weil das Plugin nur auf Klick anfragt.

***

## Anthropic (Claude) – Schlüssel anlegen

{% stepper %}
{% step %}

### Console öffnen

Öffnen Sie **<https://console.anthropic.com>** und melden Sie sich an.
{% endstep %}

{% step %}

### Zahlung und Guthaben einrichten

Öffnen Sie **Settings → Billing** – hinterlegen Sie eine Zahlungsmethode und laden Sie Guthaben auf.
{% endstep %}

{% step %}

### Schlüssel erstellen

Öffnen Sie **Settings → API Keys** → **Create Key**, vergeben Sie einen Namen und bestätigen Sie.
{% endstep %}

{% step %}

### Schlüssel kopieren

Kopieren Sie den Schlüssel (`sk-ant-…`) **sofort**. Er wird nur einmal angezeigt.
{% endstep %}

{% step %}

### Workspace-ID notieren, falls erforderlich

Nur bei **identitätsgebundenen** Schlüsseln, wenn die Meldung „anthropic-workspace-id is required" erscheint: Notieren Sie die **Workspace-ID** aus der Console. Sie kommt später in das Feld „Workspace-ID (optional)".
{% endstep %}
{% endstepper %}

### Anthropic – Ausgaben-Limit einstellen

Unter **Settings → Billing** bzw. **Limits** können Sie **Spend-Limits** und Benachrichtigungen setzen. Legen Sie auch hier einen kleinen Monatsdeckel fest und laden Sie nur so viel Guthaben, wie Sie ausgeben möchten.

***

## Eintragen im Plugin

**Log-Wächter → Konfiguration → KI-Anbieter:**

{% stepper %}
{% step %}

### Anbieter wählen

Wählen Sie den Anbieter: OpenAI ChatGPT oder Anthropic Claude.
{% endstep %}

{% step %}

### API-Schlüssel einfügen

Fügen Sie den passenden **API-Schlüssel** ein (`sk-…` bzw. `sk-ant-…`).
{% endstep %}

{% step %}

### Workspace-ID eintragen, falls erforderlich

Tragen Sie ggf. die **Workspace-ID** ein – nur für Claude und nur, falls verlangt.
{% endstep %}

{% step %}

### Anbieter freischalten

Schalten Sie den Anbieter über den **Aktiv-Schalter** frei.
{% endstep %}

{% step %}

### Modell wählen

Wählen Sie ein Modell, z. B. ein aktuelles Chat-Modell. Opus = stärkste Qualität, Haiku = am günstigsten bei Claude.
{% endstep %}

{% step %}

### Optionales Monatsbudget setzen

Setzen Sie optional das **Monatsbudget (€)**. Dieses sperrt die KI-Analyse plugin-seitig, sobald der geschätzte Verbrauch die Grenze erreicht – als zusätzlicher Schutz zum Anbieter-Limit.
{% endstep %}

{% step %}

### Speichern und Verbindung testen

Speichern Sie die Einstellungen und testen Sie die Verbindung im **Dashboard → Verbindung testen**.
{% endstep %}
{% endstepper %}

## Kostenschätzung vs. echtes Konto (wichtig)

Der im Plugin angezeigte Betrag (Dashboard „Verbrauch", Detail „Kosten") ist eine **Schätzung**. Sie wird zum Zeitpunkt des KI-Aufrufs berechnet aus den vom Anbieter gemeldeten Tokens **× den Preis-Feldern** in der Konfiguration (€ pro 1 Mio. Tokens).

{% hint style="warning" %}
Die verbindliche Abrechnung sehen Sie ausschließlich in Ihrem OpenAI- bzw. Anthropic-Konto. Der Plugin-Wert dient nur als Richtwert und als Grundlage für die plugin-eigene Budget-Bremse.
{% endhint %}

* **Preise pro Modell eintragen.** Sind die Preis-Felder **0** (oder passen nicht zum genutzten Modell), zeigt die Schätzung **0 € bzw. einen falschen Wert** – obwohl real Kosten anfallen. Tragen Sie die aktuellen Preise Ihres Modells aus dem Anbieter-Konto ein und passen Sie sie bei einem **Modellwechsel** an.
* **Preise ändern sich.** Die Anbieter passen ihre Preise regelmäßig an. Prüfen Sie sie von Zeit zu Zeit.
* **Der Anbieter-Account ist maßgeblich.** Die verbindliche Abrechnung sehen Sie ausschließlich in Ihrem OpenAI- bzw. Anthropic-Konto. Der Plugin-Wert dient nur als Richtwert und als Grundlage für die plugin-eigene Budget-Bremse.
* Wir können nicht gewährleisten, dass der KI-Dienst stets korrekte Preis- oder Token-Informationen zurückliefert; die Schätzung kann daher abweichen.

## Doppelter Kostenschutz – Zusammenfassung

* **Beim Anbieter:** kleines Guthaben, Auto-Reload aus (oder gedeckelt), Spend-Limit + Warn-Mails.
* **Im Plugin:** Monatsbudget (€) und die Tatsache, dass die KI **nie automatisch** läuft – nur auf Knopfdruck.