Einführung
Stand: 03.02.2026
Diese Seite dokumentiert das WordPress‑Plugin „Publigo / OC Book Generator“ und die dazugehörige OpenAI‑API‑Einrichtung.
Enthalten sind: API‑Key & Sicherheit, Billing/Limits, Plugin‑Installation, WooCommerce‑Credits, Frontend‑Bedienung sowie Exporte.
DOKUMENTATION PUBLIGO WORDPRESS AI-PLUGIN
Die Erstellung einer Open-AI-Api
Voraussetzungen
Ein OpenAI-Konto für die API (separat vom ChatGPT-Abo). OpenAI
Zugang zum API-Dashboard (Projects, API Keys, Billing, Usage). OpenAI Plattform
API-Key anlegen (für dein Web-Projekt)
Wo: Platform → Settings → API Keys → Create new secret key. OpenAI PlattformOpenAI Help CenterFelder & Optionen erklärt:
Owned by – You vs. Service account
You: Schlüssel ist an deinen Benutzer gebunden. Einfach für Tests/Entwicklung. Wird ungültig, wenn du aus Projekt/Organisation entfernt wirst.
Service account: Empfohlen für Produktion (Server). Eigener technischer Account mit eigener Rolle/Schlüssel, besser für Rotation & Berechtigungen. Erstellung in Project → Members → + Service account. OpenAI Help Center
Name (optional): Frei wählbares Label, z. B. „Website-Produktions-Key“.
Project: Wähle das Projekt, in dem dein Web-Use-Case läuft (z. B. „Website-LLM“). Projekte trennen Nutzung, Budgets und Berechtigungen. OpenAI Help Center
Permissions (All / Restricted / Read only):
All: Vollzugriff auf alle Endpunkte des Projekts (Standard).
Restricted: Granulare Rechte pro Endpoint (z. B. /v1/responses erlaubt, /v1/assistants gesperrt).
Read only: Nur Lesezugriffe auf API-Ressourcen. Du kannst die Berechtigungen später jederzeit anpassen. OpenAI Help Center+1
Wichtige Sicherheitsregeln (kurz):
API-Keys sind geheim. Niemals im Browser/Frontend einbetten. Immer serverseitig nutzen.
Regelmäßig rotieren (alte löschen, neue erstellen).
Teile Keys nicht mit anderen; nutze stattdessen projektbezogene Keys und Rollen. OpenAI PlattformOpenAI Help Center+1
Billing einrichten
Öffne im Dashboard Billing. Dort findest du: Overview, Payment methods, Billing history, Credit grants, Preferences.
3.1 Overview
Credit balance: Prepaid-Guthaben (neue Konten nutzen i. d. R. Prepaid). „Add to credit balance“ lädt Guthaben auf. OpenAI Help Center+1
Auto recharge: Automatisches Aufladen, damit Anfragen nicht stoppen, wenn 0 $ erreicht wird.
Schnellzugriffe auf Payment methods, Billing history, Preferences, Usage limits.
3.2 Payment methods
Lege hier die Zahlungsmethode (z. B. Kreditkarte) an. Danach kannst du Credits kaufen. OpenAI Help Center
3.3 Billing history
Einsicht in Rechnungen und deren Status; Download/Ansicht möglich. (Abrechnung je nach Plan monatlich; Prepaid verrechnet sich mit Guthaben.) OpenAI Plattform
3.4 Credit grants
Zeigt Gutschein-/Startguthaben (falls vorhanden) mit Restwert & Ablaufdatum.
3.5 Preferences
Company name: Absender/Name auf künftigen Rechnungen.
PO number (Bestellnummer): Wird auf künftigen Rechnungen ausgewiesen (praktisch für Buchhaltung). Änderungen gelten nur für zukünftige Rechnungen. OpenAI Help Center
Limits & Budgets (Kostenkontrolle)
Organization / Project Budget: Lege ein monatliches Budget und E-Mail-Alerts (z. B. 80 % / 100 %) fest.
Wichtig: Projekt-Budgets sind „soft limits“ – Anfragen laufen weiter; sie dienen primär zur Überwachung & Benachrichtigung. Nutze Alerts und regelmäßige Kontrolle im Usage-Bereich. OpenAI Help Center
Wo: Settings → Limits (Org) bzw. Project → Limits (Projekt). OpenAI Help CenterPreise der Modelle (Überblick)
Die offizielle Preisliste findest du hier: API Pricing. Nachfolgend die am häufigsten genutzten Optionen für Text & Bilder (Stand laut Preisseite): OpenAI
„Cached Input“ ist günstiger, wenn Prompt-Teile aus dem Cache wiederverwendet werden (Details auf der Preisseite & in den Docs). OpenAI
Dein Screenshot zur Preisübersicht:
Beispielrechnung (einfach & realistisch)
Szenario: 100 Aufrufe mit GPT-4o mini, je 1.200 Input-Tokens und 500 Output-Tokens.
Input: 100 × 1.200 = 120.000 Tokens = 0,12 M × $0,60 = $0,072
Output: 100 × 500 = 50.000 Tokens = 0,05 M × $2,40 = $0,12 Gesamt: $0,192 für 100 Antworten (≈ 0,19 $). Preise gemäß OpenAI Preisseite. OpenAI
Usage-Statistiken verstehen
Total Spend: Bisherige Kosten im gewählten Zeitraum (oben rechts Datumsfilter).
Budget-Leiste: Fortschritt gegen dein Monatsbudget; „Edit budget“ führt zu Limits.
Total tokens / Total requests: Summe Tokens bzw. API-Requests im Zeitraum.
Group by (1d/7d/30d): Tages-, Wochen-, Monats-Balken.
Filter „All projects“: Auf Projekt-Ebene herunterbrechen.
Tabs unten:
API capabilities: Aufschlüsselung nach Funktionsbereichen (z. B. Chat Completions/Responses, Images …).
Users / Services / API Keys: Welche Nutzer/Service-Accounts oder Keys verursachen Kosten.
Export: CSV-Export für Controlling/Buchhaltung. (Weitere Details in den offiziellen Usage-Hilfeseiten.) OpenAI Help Center+1
Projekte & Team-Setup (Best Practices)
Projekte trennen Teams/Produkte/Umgebungen (z. B. Staging vs. Production), haben eigene Budgets, Limits, Mitglieder und Service-Accounts. OpenAI Help Center
Service-Accounts für Server/Produktivbetrieb nutzen; persönliche Keys nur für lokale Tests. OpenAI Help Center
Eingeschränkte Keys (Restricted) für enge Aufgaben (z. B. nur /v1/responses), um Risiko zu minimieren. OpenAI Help Center
Key-Sicherheit: Nicht im Frontend ausliefern, regelmäßig rotieren, Budget-Alerts setzen. OpenAI Help Center+1
Einbindung auf einer externen Website (ohne Programmierhintergrund)
Grundprinzip (sehr wichtig): Der API-Key bleibt auf dem Server. Deine Website (Formular/Frontend) schickt die Anfrage an deinen Server/Plugin, dieser ruft die OpenAI-API mit deinem Key auf und gibt nur die Antwort zurück.
Mögliche Wege für Nicht-Programmierer:
WordPress: Nutze ein Plugin, das die OpenAI-Anfrage serverseitig ausführt (Key im Backend hinterlegt). Achte darauf, dass kein Key im Browser sichtbar ist.
No-Code/Low-Code: Tools wie Automations/Integrationen, die einen Webhook/Endpoint bereitstellen (Server-seitig), den du aus deiner Seite aufrufst.
Playground zum Testen: Ideen und Prompts dort ausprobieren – Nutzung wird ganz normal abgerechnet. OpenAI
Dok-Links für den technischen Part (für dich oder deinen Tech-Partner):
API-Referenz (Beispiele in cURL/Python/JS): Endpunkte, Parameter, Fehlercodes. OpenAI Plattform+1
Webhooks (optional, für asynchrone Workflows): OpenAI Plattform
Häufige Fragen (Quick-Answers mit Quellen)
Wo finde ich meinen API-Key? Im API-Dashboard unter API Keys. OpenAI Help Center
Gibt es getrennte Preise pro Modell & Tool? Ja, Pricing nach Modell (Tokens) und ggf. Tools (z. B. Code Interpreter, File Search). OpenAI
Zählt Playground-Nutzung in die Kosten? Ja. OpenAI
Mini-Checkliste „Go-Live“
Projekt anlegen, Mitglieder & Rollen setzen. OpenAI Help Center
Service-Account erstellen, Restricted API-Key erzeugen. OpenAI Help Center
Payment method + Credits aufladen. OpenAI Help Center+1
Budget & Alerts konfigurieren. OpenAI Help Center
Server-seitige Integration (Plugin/Backend) – Key bleibt geheim. OpenAI Help Center
Usage regelmäßig prüfen, Export für Controlling. OpenAI Help Center
Wenn du möchtest, formatiere ich das als druckfertiges PDF/Handout (Corporate-Design, mit allen Screens) oder passe die Inhalte an dein WordPress-Setup an.
Die Installation und das Einrichten des Plugin
Installation des Plugins
Lade das OC Book Generator Plugin herunter (ZIP-Datei).
Gehe in deinem WordPress-Backend auf Plugins → Installieren → Plugin hochladen.Wähle die ZIP-Datei aus und klicke auf Jetzt installieren.
Aktiviere das Plugin.
👉 Nach der Aktivierung erscheint im WordPress-Menü der Eintrag OC Book Generator.
Seitenerstellung & Shortcode einbinden
Damit deine Kunden den Generator nutzen können, muss eine Seite angelegt werden.
Gehe auf Seiten → Erstellen.Vergib einen Titel, z. B. „Buch-Generator starten“.
Füge in den Inhalt den Shortcode des Plugins ein (z. B. [oc_book_generator]).
Veröffentliche die Seite.
➡️ Ab sofort wird auf dieser Seite der Generator dargestellt und kann von Kunden mit Credits genutzt werden.
Einstellungen im Backend
Öffne OC Book Generator → Einstellungen.
Du siehst das zentrale Konfigurationsmenü (siehe Screenshot).Wichtige Felder:
OpenAI API Key Trage hier deinen API-Schlüssel ein. Ohne diesen Schlüssel funktioniert der Generator nicht.
Modell Gib das gewünschte OpenAI-Modell ein (z. B. gpt-4o oder gpt-4o-mini).
Kauf-Link (Produkt/Kategorie) URL zu deinem WooCommerce-Produkt oder einer Kategorie. Dieser Link erscheint später im Button „Freischaltung kaufen“.
Produkt-IDs für Credit-Gutschrift Kommaseparierte Liste der WooCommerce-Produkt-IDs, bei deren Kauf automatisch Credits gutgeschrieben werden.
Credits pro Kauf Bestimmt, wie viele Credits pro Kauf dem Nutzerkonto gutgeschrieben werden.
Prompt Hier definierst du die genaue Arbeitsanweisung für die KI. Dieser Prompt wird 1:1 an OpenAI übergeben.
Verbindung zu WooCommerce
Damit Credits automatisch nach einem Kauf vergeben werden, muss das Plugin mit WooCommerce-Produkten verknüpft sein.
Produkt anlegen
Gehe zu Produkte → Erstellen.Lege ein einfaches Produkt an, z. B. „Buchgenerator Credit“.
Trage Preis & Beschreibung ein.
Veröffentliche das Produkt.
Produkt-ID finden
Die Produkt-ID findest du in der Produktübersicht, wenn du mit der Maus über den Produkttitel fährst.
Trage diese ID in den Plugin-Einstellungen unter „Produkt-IDs für Credit-Gutschrift“ ein.
Verwaltung der Credits
Jeder registrierte Nutzer hat ein eigenes Credit-Konto.
Aktuelle Credits: Zeigt, wie viele Starts für den Generator verfügbar sind.
Credits ändern:
Gib eine Zahl ein und wähle zwischen Auf-/Absummieren (z. B. +2 oder -1 Credits) oder Absolut setzen (z. B. 10 Credits fix).
Klick auf Speichern, um die Änderung zu übernehmen.
➡️ Damit kann der Admin Credits manuell vergeben oder abziehen (z. B. Kulanz oder Supportfälle).
Typischer Ablauf für Kunden
Kunde registriert sich und kauft ein Produkt (z. B. 1 Credit für 49,99 €).
Nach dem Kauf wird der Credit automatisch gutgeschrieben.
Kunde geht auf die Generator-Seite → startet mit seinem Credit den Buchgenerator.Der Generator führt den im Backend hinterlegten Prompt aus.
Credits werden nach jeder Nutzung abgezogen.
Best Practices
API Key geheim halten: Niemals öffentlich auf der Website sichtbar machen.
Testprodukt anlegen: Zum Prüfen der Integration empfiehlt sich ein günstiges Testprodukt.
Credits-Überwachung: Regelmäßig die Credit-Konten prüfen, ob automatische Gutschriften funktionieren.
Shortcodes mehrfach nutzbar: Du kannst den Generator auf mehreren Seiten einbinden (z. B. für verschiedene Produkte mit unterschiedlichen Prompts).
Die Elemente der Frontend-LLM-Anwendung
Backend (Admin-Bereich)
Die wichtigsten Einstellmöglichkeiten hast du im Backend unter OC Book Generator → Einstellungen:OpenAI API Key
Hier wird der persönliche OpenAI-Schlüssel eingetragen. Ohne gültigen Key funktioniert der Generator nicht.
Modell
Bestimmt, welches KI-Modell verwendet wird (z. B. gpt-4o, gpt-4o-mini).
Je nach Modell unterscheiden sich Kosten, Geschwindigkeit und Textqualität.
Kauf-Link (Produkt/Kategorie)
URL eines WooCommerce-Produkts oder einer Kategorie.
Dieser Link erscheint als Button „Freischaltung kaufen (49,99 €)“ im Frontend.
Produkt-IDs für Credit-Gutschrift
Hier werden die WooCommerce-Produkt-IDs hinterlegt, die beim Kauf Credits gutschreiben.
Beispiel: 901476321009661.
Credits pro Kauf
Legt fest, wie viele Credits pro Kauf vergeben werden.
Prompt
Der Kern des Generators: Dieses Textfeld enthält die genaue Anweisung an die KI (z. B. „erstelle Buchideen, Inhaltsverzeichnis, Kapitel…“).
Dieser Text wird 1:1 an die API gesendet.
Credit-Verwaltung pro Nutzer
Unter Benutzer → Nutzer bearbeiten findest du die Sektion OC Book Generator – Credits:Aktuelle Credits: Zeigt die verfügbaren Starts.
Credits ändern: Admin kann Credits manuell hinzufügen, abziehen oder auf einen festen Wert setzen.
Frontend (Kundensicht)
Dein Screenshot zeigt die Nutzeroberfläche, die auf der Seite mit dem Shortcode [oc_book_generator] eingebettet ist.
Elemente im Detail
Statusleiste oben
Nicht eingeloggt: Hinweis, dass ein Login nötig ist, um den Generator zu nutzen.
Jetzt einloggen (Button): Führt zur WordPress-Anmeldeseite.
Deine Credits: 0: Zeigt an, wie viele Starts der User aktuell noch hat.
Freischaltung kaufen (49,99 €): Verlinkt auf das WooCommerce-Produkt. Mit Klick kauft der Nutzer Credits (Preis aus Plugin-Einstellungen).
Hinweistext
„Jeder Start kostet 49,99 € = 1 Credit …“
Erklärt die Preis- und Credit-Logik.
Hinweis „weiter“ bedeutet: Wenn die KI-Ausgabe abbricht, kann der User im Eingabefeld „weiter“ eingeben, um die Generierung fortzuführen.
Bucherstellung starten (Button)
Startet die eigentliche Anfrage an OpenAI.
Ein Credit wird dabei vom Konto abgezogen.
Freies Eingabefeld (rechts daneben)
Hier kann der Nutzer auf Fragen des Prompts reagieren (z. B. Auswahl eines Buchthemas oder Schreibstils).
Die Eingabe wird beim nächsten Promptdurchlauf an die KI weitergegeben.
Ausgabefeld (große weiße Fläche)
Hier erscheinen die Antworten der KI: Themen, Inhaltsverzeichnis, Kapiteltexte usw.
Ausgabe kann sehr umfangreich sein (mehrere Seiten Text).
Eingabefeld unten („Antwort eingeben“)
Nutzer gibt hier zusätzliche Befehle ein (z. B. „3 / sachlich / weiter“).
Wird genutzt, um zu steuern, wie die KI fortfahren soll.
Senden (Button)
Sendet den eingegebenen Text an die KI.
Export- und Download-Buttons
Als Word (.doc) herunterladen: Export des Textes als Word-Datei.
Als .txt herunterladen: Export als einfache Textdatei.
In Zwischenablage kopieren: Kopiert den kompletten Text ins Clipboard.
.md exportieren: Export als Markdown-Datei (für Entwickler oder GitHub-Nutzer).
.json exportieren: Export als JSON-Datei (z. B. für Weiterverarbeitung in anderen Tools).
Typischer Nutzer-Workflow
User loggt sich ein.
Prüft Credits oben rechts.
Falls keine Credits: Klick auf „Freischaltung kaufen (49,99 €)“.
Nach Kauf → Credits werden automatisch gutgeschrieben.Klick auf „Bucherstellung starten“.
Eingaben machen (z. B. Themenauswahl, Schreibstil).
KI generiert das Buch, Ausgabe erscheint im weißen Feld.
Ergebnis herunterladen oder exportieren.
Vorteile für Nutzer
Klarer Ablauf: Login → Credits kaufen → Starten.Transparenz: Credits und Kosten jederzeit sichtbar.
Flexibilität: Eingaben jederzeit möglich, Ausgabe kann unterbrochen und fortgeführt werden.
Direkter Export: Ergebnisse in verschiedenen Formaten nutzbar.