Setup

1. OpenAI API-Schlüssel erhalten

  1. Besuche die OpenAI Platform
  2. Erstelle ein Konto oder melde dich an
  3. Navigiere zu „API Keys“ in deinem Dashboard
  4. Erstelle einen neuen API-Schlüssel
  5. Wichtig: Kopiere den Schlüssel sofort – er wird nur einmal angezeigt

2. Extension konfigurieren

  1. Gehe im TYPO3 Backend zu Admin Tools → Settings → Extension Configuration
  2. Wähle AI Image Text aus der Liste
  3. Konfiguriere folgende Einstellungen:

OpenAI API Einstellungen

API Key OpenAI: [Dein OpenAI API-Schlüssel]
API Model OpenAI: gpt-4o (empfohlen)

AI-Parameter (Optional – Standardwerte funktionieren gut)

Temperature: 0.5 (Kreativität: 0.0-1.0)
Max Tokens: 275 (Maximale Textlänge)
Top P: 1 (Wahrscheinlichkeitsfilter)
Frequency Penalty: 0.8 (Wortwiederholungen vermeiden)
Presence Penalty: 0 (Themenabweichung vermeiden)

Firmenkontext (Optional – für bessere Ergebnisse)

Firmenname: [Dein Firmenname]
Firmenbeschreibung: [Kurze Beschreibung deines Unternehmens]
Domain hinzufügen.

Erweiterte Einstellungen

Bildname in Prompt verwenden: (Falls Dateiname relevant ist)
Anzahl Vorschläge: 2 (Anzahl der generierten Textoptionen)

3. Extension verwenden

  1. Datei-Modul öffnen: Gehe zu Web → File → Filelist
  2. Bild auswählen: Klicke auf ein Bild und dann auf Edit Metadata
  3. AI-Buttons nutzen: Du siehst jetzt AI-Buttons bei den Feldern:
    • Title: Für Bildtitel
    • Alternative Text: Für Alt-Attribute
    • Description: Für Bildbeschreibungen
  4. Text generieren:
    • Klicke auf einen AI-Button
    • Die Extension analysiert das Bild
    • Wähle aus den generierten Vorschlägen
    • Klicke auf Übernehmen oder Abbrechen

4. Prompt-Anpassung (Optional)

Falls du die Standard-Prompts anpassen möchtest:

  1. Gehe zu Extension Configuration → AI Image Text
  2. Bearbeite die Prompt-Felder:
    • AI Image Title: Prompt für Bildtitel
    • AI Image Alt: Prompt für Alt-Text
    • AI Image Description: Prompt für Beschreibungen
    • AI Image All: Prompt für alle Felder gleichzeitig

Standard-Prompt Beispiel:

Betrachte das folgende Bild: Generiere einen kreativen, SEO-optimierten
Titel für dieses Bild, der relevante Schlüsselwörter für
Suchmaschinenoptimierung beinhaltet. Der Titel sollte die Hauptelemente
und die Stimmung des Bildes einfangen und für die Nutzer ansprechend sein.

Workflow-Empfehlungen

Für optimale Ergebnisse:

  1. Firmenkontext hinzufügen: Trage Firmennamen und -beschreibung ein
  2. Bildqualität: Verwende hochauflösende, klare Bilder
  3. Mehrere Vorschläge nutzen: Lasse 2-3 Optionen generieren
  4. Nachbearbeitung: Passe generierte Texte bei Bedarf an
  5. Konsistenz: Verwende ähnliche Prompts für ähnliche Bildtypen

Troubleshooting

AI-Buttons erscheinen nicht:

  • Prüfe die Installation (siehe Install.md)
  • Leere den TYPO3 Cache
  • Überprüfe Benutzerrechte

API-Fehler:

  • Prüfe deinen OpenAI API-Schlüssel
  • Kontrolliere dein OpenAI-Guthaben
  • Teste die Internetverbindung

Schlechte Textergebnisse:

  • Passe die Prompts an
  • Füge Firmenkontext hinzu
  • Ändere die Temperature-Einstellung

Performance-Probleme:

  • Reduziere Max Tokens
  • Verringere die Anzahl der Vorschläge
  • Nutze das günstigere GPT-3.5-Model (falls verfügbar)