Zum Hauptinhalt springen

OpenAI API-Schlüssel einrichten

Dieser Leitfaden zeigt Ihnen im Detail, wie Sie einen OpenAI API-Schlüssel erstellen, verwalten und in Shopware hinterlegen.

Was ist ein API-Schlüssel?​

Ein API-Schlüssel ist wie ein Passwort, mit dem Ihr Shopware-System auf Ihr OpenAI-Konto zugreift. Er ermöglicht:

  • 🔑 Sichere Authentifizierung bei OpenAI
  • 💳 Zuordnung der Nutzung zu Ihrem Konto
  • 📊 Nachverfolgung der API-Aufrufe und Kosten
  • 🔒 Kontrolle über Berechtigungen
Sicherheitshinweis

Behandeln Sie Ihren API-Schlüssel wie ein Passwort! Teilen Sie ihn niemals öffentlich und speichern Sie ihn sicher. Jeder mit Zugriff auf den Schlüssel kann auf Ihre Kosten API-Anfragen stellen.

OpenAI-Konto erstellen​

Schritt 1: Registrierung​

  1. Besuchen Sie platform.openai.com
  2. Klicken Sie auf Sign Up (Registrieren)
  3. Wählen Sie eine Registrierungsmethode:
    • E-Mail-Adresse + Passwort
    • Google-Konto
    • Microsoft-Konto
    • Apple-Konto

Schritt 2: E-Mail verifizieren​

  1. Prüfen Sie Ihr E-Mail-Postfach
  2. Klicken Sie auf den Bestätigungslink in der E-Mail von OpenAI
  3. Ihre E-Mail-Adresse ist nun verifiziert

Schritt 3: Organisation erstellen (Optional)​

Wenn Sie OpenAI geschäftlich nutzen:

  1. Gehen Sie zu Settings → Organization
  2. Geben Sie Ihren Firmennamen ein
  3. Speichern Sie die Änderungen

Zahlungsmethode hinterlegen​

OpenAI arbeitet nach dem Pay-as-you-go Prinzip: Sie zahlen nur für das, was Sie tatsächlich nutzen.

Schritt 1: Billing-Bereich öffnen​

  1. Melden Sie sich bei platform.openai.com an
  2. Klicken Sie oben rechts auf Ihr Profil
  3. Wählen Sie Settings → Billing
  4. Oder direkt: platform.openai.com/settings/organization/billing

Schritt 2: Zahlungsmethode hinzufügen​

  1. Klicken Sie auf Add payment method
  2. Wählen Sie eine Zahlungsmethode:
    • Kreditkarte (Visa, Mastercard, American Express)
    • Oder alternative Methoden (je nach Region)
  3. Geben Sie Ihre Zahlungsdaten ein
  4. Klicken Sie auf Save payment method

Schritt 3: Startguthaben aufladen​

  1. OpenAI verlangt ein Mindestguthaben (meist 5-10 USD)
  2. Wählen Sie einen Betrag (z.B. 20 USD)
  3. Klicken Sie auf Continue
  4. Bestätigen Sie die Zahlung
Budgetempfehlung

Für einen kleinen bis mittleren Online-Shop reichen 10-20 EUR pro Monat vollkommen aus. Durch Token-Caching (50-90% Ersparnis) sind die tatsächlichen Kosten oft noch niedriger!

Schritt 4: Automatische Aufladung einrichten (Optional)​

  1. Gehen Sie zu Billing → Auto recharge
  2. Aktivieren Sie die automatische Aufladung
  3. Legen Sie fest:
    • Schwellenwert: Bei welchem Guthaben nachladen? (z.B. 5 USD)
    • Auflade-Betrag: Wie viel aufladen? (z.B. 20 USD)
  4. Speichern Sie die Einstellungen

Das verhindert, dass Ihr Agent bei leerem Guthaben plötzlich nicht mehr funktioniert.

Schritt 5: Budget-Limit setzen (Empfohlen!)​

Schützen Sie sich vor unerwarteten Kosten:

  1. Gehen Sie zu Billing → Limits
  2. Setzen Sie ein monatliches Budget-Limit (z.B. 50 USD)
  3. Aktivieren Sie E-Mail-Benachrichtigungen bei 80% und 100%
  4. Speichern Sie
Budget geschützt

Wenn Ihr Limit erreicht ist, stoppt OpenAI automatisch alle Anfragen – so können keine überraschenden Kosten entstehen!

API-Schlüssel erstellen​

Schritt 1: API Keys Bereich öffnen​

  1. Gehen Sie zu Settings → API keys
  2. Oder direkt: platform.openai.com/api-keys

Schritt 2: Neuen Schlüssel erstellen​

  1. Klicken Sie auf + Create new secret key
  2. Ein Dialog öffnet sich

Schritt 3: Schlüssel konfigurieren​

Name (erforderlich):

Shopware Production

Wählen Sie einen aussagekräftigen Namen, damit Sie später wissen, wofür dieser Schlüssel verwendet wird

Berechtigungen (Permissions):

  • Wählen Sie All (Alle Berechtigungen)
  • Oder für mehr Sicherheit: Nur Model capabilities

Projekt (Optional):

  • Falls Sie Projekte nutzen, wählen Sie das passende aus
  • Sonst: Standard-Projekt

Schritt 4: Schlüssel erstellen und kopieren​

  1. Klicken Sie auf Create secret key
  2. Der Schlüssel wird nur einmal angezeigt!
  3. Klicken Sie auf Copy (Kopieren)
  4. Speichern Sie den Schlüssel an einem sicheren Ort (z.B. Passwort-Manager)

Der Schlüssel sieht so aus:

sk-proj-aBcDeFgHiJkLmNoPqRsTuVwXyZ1234567890abcdefghijklmnopqrstuvwxyz...
Nur einmal sichtbar!

OpenAI zeigt den Schlüssel nur ein einziges Mal an. Falls Sie ihn nicht kopiert haben oder verlieren, müssen Sie einen neuen Schlüssel erstellen. Der alte kann nicht wiederhergestellt werden!

Schritt 5: Schlüssel bestätigen​

  1. Setzen Sie das Häkchen bei "I have saved my key"
  2. Klicken Sie auf Done

API-Schlüssel in Shopware hinterlegen​

Methode 1: Über Plugin-Konfiguration (Empfohlen)​

  1. Melden Sie sich im Shopware-Backend an
  2. Gehen Sie zu Einstellungen → System → Plugins
  3. Suchen Sie OpenAI Agents Manager (FelOAIAssistantsManager)
  4. Klicken Sie auf die drei Punkte (⋮) → Konfigurieren
  1. Finden Sie das Feld "API Key for the Agent Manager"
  2. Fügen Sie Ihren kopierten OpenAI API-Schlüssel ein
  3. Klicken Sie auf Test API Key (Button erscheint nach Eingabe)
  4. Bei erfolgreichem Test erscheint eine grüne Erfolgsmeldung
  5. Klicken Sie auf Speichern
Verbindung hergestellt

Wenn der Test erfolgreich war, ist Ihr Shopware-System jetzt mit OpenAI verbunden!

Methode 2: Über Umgebungsvariablen (Fortgeschritten)​

Für mehr Sicherheit können Sie den API-Schlüssel auch als Umgebungsvariable hinterlegen:

  1. Öffnen Sie Ihre .env Datei im Shopware-Root
  2. Fügen Sie hinzu:
OPENAI_API_KEY=sk-proj-IhrSchlüsselHier...
  1. Speichern Sie die Datei
  2. Cache leeren:
bin/console cache:clear

Das Plugin liest den Schlüssel dann automatisch aus der Umgebungsvariable.

API-Schlüssel testen​

Test im Plugin​

Das Plugin bietet einen integrierten Test:

  1. Gehen Sie zur Plugin-Konfiguration
  2. Geben Sie den API-Schlüssel ein
  3. Klicken Sie auf "Test API Key"

Das System prüft:

  • ✅ Ist der Schlüssel gültig?
  • ✅ Hat das OpenAI-Konto Guthaben?
  • ✅ Sind die Berechtigungen korrekt?

Test über Backend-Chat​

Alternativ können Sie einen Live-Test durchführen:

  1. Öffnen Sie 5E OAI Agent Manager → Chat
  2. Falls Sie schon einen Agenten erstellt haben, senden Sie eine Testnachricht
  3. Wenn eine Antwort kommt, funktioniert alles! ✅

API-Schlüssel verwalten​

Mehrere Schlüssel verwenden​

Sie können mehrere API-Schlüssel erstellen:

  • Produktions-Schlüssel: Für Live-Shop
  • Test-Schlüssel: Für Entwicklung/Staging
  • Backup-Schlüssel: Falls der Haupt-Schlüssel kompromittiert wird

Schlüssel-Berechtigungen ändern​

  1. Gehen Sie zu platform.openai.com/api-keys
  2. Klicken Sie auf den Schlüssel
  3. Ändern Sie die Berechtigungen
  4. Speichern

Schlüssel deaktivieren/löschen​

Falls ein Schlüssel kompromittiert wurde:

  1. Gehen Sie zu platform.openai.com/api-keys
  2. Finden Sie den betroffenen Schlüssel
  3. Klicken Sie auf Revoke (Widerrufen)
  4. Bestätigen Sie
Sofort deaktivieren!

Wenn Sie vermuten, dass Ihr API-Schlüssel öffentlich wurde (z.B. versehentlich in GitHub hochgeladen), deaktivieren Sie ihn sofort!

Neuen Schlüssel erstellen (wenn alter verloren)​

  1. Erstellen Sie einen neuen Schlüssel (siehe oben)
  2. Tragen Sie ihn in Shopware ein
  3. (Optional) Löschen Sie den alten Schlüssel in OpenAI

Nutzung & Kosten überwachen​

OpenAI Dashboard​

Behalten Sie Ihre Kosten im Blick:

  1. Gehen Sie zu platform.openai.com/usage
  2. Hier sehen Sie:
    • Tägliche API-Aufrufe
    • Kosten pro Tag/Monat
    • Genutzter Model-Mix
    • Token-Verbrauch

Wichtige Metriken verstehen​

MetrikBedeutung
RequestsAnzahl der API-Anfragen
TokensVerarbeitete Text-Einheiten
CostKosten in USD
Cached TokensDurch Caching eingesparte Tokens

E-Mail-Benachrichtigungen​

Aktivieren Sie Benachrichtigungen:

  1. Gehen Sie zu Settings → Billing → Notifications
  2. Aktivieren Sie:
    • ✅ Tägliche Nutzungs-Zusammenfassung
    • ✅ Budget-Warnungen (bei 80%, 90%, 100%)
    • ✅ Guthaben niedrig

Kosten-Optimierung​

Token-Caching nutzen​

Das Plugin nutzt automatisch OpenAIs Prompt Caching:

  • 🎯 50-90% Kosten-Ersparnis bei wiederholten Anfragen
  • 📊 Cached Tokens kosten nur einen Bruchteil (z.B. $0.08 statt $0.15 pro 1M Tokens)

Keine Konfiguration nötig – funktioniert automatisch!

Günstigeres Modell wählen​

ModellKosten (Input)GeschwindigkeitEmpfehlung
gpt-4o-mini$0.15 / 1M tokens⚡⚡⚡ Sehr schnell✅ Start hier
gpt-4o$2.50 / 1M tokens⚡⚡ SchnellFür komplexe Aufgaben
gpt-5~$5.00 / 1M tokens⚡ LangsamNur wenn nötig

Tools reduzieren​

Je weniger Tools aktiviert, desto:

  • ⬇️ Weniger Token in Instructions
  • ⬇️ Weniger Funktionsaufrufe
  • ⬇️ Niedrigere Kosten

Aktivieren Sie nur Tools, die Sie wirklich brauchen!

Troubleshooting​

Problem: "Invalid API Key"​

Ursachen:

  • Schlüssel falsch kopiert (Leerzeichen am Anfang/Ende?)
  • Schlüssel wurde widerrufen
  • Schlüssel gehört zu anderer Organisation

Lösung:

  1. Kopieren Sie den Schlüssel erneut
  2. Prüfen Sie auf Leerzeichen
  3. Erstellen Sie ggf. neuen Schlüssel

Problem: "Insufficient quota"​

Bedeutung: Ihr OpenAI-Guthaben ist aufgebraucht.

Lösung:

  1. Gehen Sie zu platform.openai.com/settings/organization/billing
  2. Laden Sie Guthaben auf
  3. Oder aktivieren Sie automatische Aufladung

Problem: "Rate limit exceeded"​

Bedeutung: Zu viele Anfragen in kurzer Zeit.

Lösung:

  • Warten Sie 1-2 Minuten
  • Erhöhen Sie das Rate Limit in OpenAI (für zahlende Kunden)

Problem: API Key funktioniert nicht in Shopware​

Prüfliste:

  1. ✅ Ist das Plugin aktiviert?
  2. ✅ Ist der Schlüssel vollständig kopiert?
  3. ✅ Hat das OpenAI-Konto Guthaben?
  4. ✅ Wurde der Cache geleert? (bin/console cache:clear)

Nächste Schritte​

Sie haben jetzt:

  • ✅ Ein OpenAI-Konto erstellt
  • ✅ Eine Zahlungsmethode hinterlegt
  • ✅ Einen API-Schlüssel generiert
  • ✅ Den Schlüssel in Shopware eingetragen

Weiter geht's mit:

➡️ Ersten Agenten erstellen - Schritt-für-Schritt Anleitung

➡️ Agenten-Konfiguration - Alle Einstellungen erklärt

➡️ Kosten-Management - Kosten optimieren und überwachen