Extension Configuration

In the following section, you will find all the existing configuration options for the AI Suite. In the square brackets, the first value is the respective configuration key and the second value is the respective data type. As of versions 13.0.0/12.6.0/11.3.0, all extension configurations can be overwritten by user group-specific configurations.

Extension settings

All settings at a glance

License & server

License data for the server and, if your site is protected by an access restriction, the HTTP basic authentication. The latter is available since versions 12.7.0 and 13.1.0. Without it the AI Suite cannot fetch a protected page, which affects metadata generation among other things.

AI Suite license Key (aiSuiteApiKey, string): Your license key generated at www.autodudes.de. Without it none of the AI functions work.
AI Suite server (aiSuiteServer, string): Address of the AutoDudes server. As a rule, leave it unchanged.

Default: https://api.autodudes.de/
System domain (aiSuiteSystemDomain, string): Since 14.5.0/13.17.0/12.23.0. The domain this installation is licensed for. It is needed for CLI and cron runs, where no HTTP host is available. If the field stays empty, the domain is derived from the site configuration.

Default: empty
Enable Basic Authentication (basicAuth.enable, boolean): Enables authentication with username and password for every request the AI Suite makes to your site.

Default: off
Username (basicAuth.user, string): The username of the access restriction, not that of a TYPO3 backend user.
Password (basicAuth.pass, string): The matching password. It is stored in plain text in the extension configuration, so it applies to the access restriction only and should not be reused anywhere else.

Own API keys

This tab matters for everyone on a subscription. The keys stored here are used together with your license key. Grouped into text models, translation services and image models.

Enter your OpenAI API key (openAiApiKey, string)
Enter your Anthropic API key (anthropicApiKey, string)
Enter your AI Model Hub API key (aiModelHubApiKey, string): IONOS, also used for Flux.
Enter your Staan API key (staanApiKey, string): Only needed on a plan that runs on your own provider keys, and there only for web research in GDPR mode.
Enter your GoogleTranslate API key (googleTranslateApiKey, string)
Enter your DeepL API key (deeplApiKey, string)
Free version of DeepL API (deeplApiMode, boolean): Switch this on if you use the free DeepL API. The two variants address different endpoints.

Default: off
Enter your Midjourney API key (midjourneyApiKey, string): Midjourney cannot yet be used out of the box with the subscription model. Please get in touch with us directly about it.
Enter your Midjourney ID (midjourneyId, string)

Translation

Covers the general translation settings as well as automatic translation on save. The latter is available since versions 14.3.0/13.15.0/12.21.0 and described in detail under Automatic Translation on Save.

Disable whole translation functionality (disableTranslationFunctionality, boolean): Switches off the entire translation function. Use with care, because automatic translation stops working as well.

Default: off
Translate FlexForm fields (translateFlexFormFields, boolean): When FlexForm translations were introduced in versions 13.2.0/12.8.0, the option to switch this function on and off was added with them.

Default: on
Update DeepL glossaries (updateDeeplGlossaries, boolean): Keeps the glossaries stored at DeepL in sync with your glossary entries in TYPO3, see Glossary function.

Default: on
Use the following library for "Einfache Sprache" translations (easyLanguageLibrary, options): Available are OpenAI, Claude and Meta Llama-3.3 (70B-Instruct). Added together with the AI plugin for easy language in versions 13.3.0/12.9.0.

Default: ChatGPT
Automatically translate content elements into all site languages on save (enableAutoTranslateOnSave, boolean): Switches automatic translation on. Without it the following three settings have no effect.

Default: off
Processing mode for automatic translation (autoTranslateMode, options): Three choices: "Page module" applies finished translations when the page module is opened and shows the status in the page tree. "CLI scheduler" requires ai-suite:process-tasks to be running. "Directly on save" translates synchronously, which blocks the save and only suits a small number of languages.

Default: pageModule
Model used for automatic translation on save (autoTranslateModel, options): Available are OpenAI, DeepL, Google Translate, Claude and Mittwald AI.

Default: ChatGPT
Safety cap: maximum number of content elements a single save may auto-translate (autoTranslateMaxElementsPerSave, int+): If a save changes more elements than allowed here, for instance during a bulk edit, automatic translation is skipped for that save and the editor is notified. A value of 0 lifts the limit.

Default: 15
Open the translated record in edit mode (openTranslatedRecordInEditMode, boolean): This setting no longer exists.

It controlled whether a translated record opens directly in the editing mask or whether you stay in the overview of the list module.

Default: n/a

Metadata

Covers metadata generation in the wizard as well as automatic generation, which takes effect as soon as a file is uploaded to the file list.

Amount of metadata suggestions to be displayed (metadataSuggestionCount, options): How many suggestions per field the metadata wizard offers, selectable from 1 to 5.

Default: 5
Minimum number of characters of fetched page content (minPlausiblePageContentLength, int+): Lower bound of characters a fetched page must have before its content is sent to the AI for metadata generation. Protects against metadata being invented from a nearly empty page.

Default: 100
Generate image titles automatically on file upload (metadataAutogenerateTitle, boolean): Default: off
Generate alternative text automatically on file upload (metadataAutogenerateAlternative, boolean): Default: off
Use the following library for autogenerated metadata generation on file upload (metadataAutogenerateModel, options): Default: Vision
How to handle autogenerated file metadata? (metadataAutogenerateApproach, options): Either the suggestions land in the TaskEngine and are reviewed there, or the first suggestion is saved directly.

Default: taskEngine
Own prompt for autogenerated file metadata on upload (metadataAutogeneratePrompt, string): Since 14.4.0/13.16.0/12.22.0. Replaces the predefined instruction. If you leave the field empty, the standard instruction stays active.

Default: empty
Detail plugin for displaying records from EXT:news (singleNewsDisplayPage, int+): Replaced with dynamic queries during the generation process in versions 13.0.0/12.6.0/11.3.0.

Default: n/a
Always use URL for metadata requests (useUrlForRequest, boolean): Removed in versions 13.0.0/12.6.0/11.3.0.

Default: n/a

General

Media storage, data protection, background tasks and the settings of the audit module. The latter are available since versions 14.5.0/13.17.0/12.23.0 and described in detail under AI Audit.

Store image and media files at this folder (mediaStorageFolder, string): Relative path to the folder where images and media generated with the AI Suite are stored, for example ai-images/subfolder. A combined identifier such as 1:/user_upload/ai-images works too. If the folder does not exist, it is created.

Default: empty
Only load GDPR-compliant libraries (forceGdpa, boolean): Restricts the choice to those AI models marked as GDPR-compliant on the AI Suite server. Models without that marking then disappear from every selection.

Default: off
Maximum number of CLI background tasks processed per scheduler run (maxTasks, int+): Limits how many background tasks one run of ai-suite:process-tasks works through. See CLI commands.

Default: 50
WCAG conformance level for accessibility audits (auditWcagStandard, options): WCAG 2 Level A, AA and AAA are available. The value controls the HTML_CodeSniffer run. The axe run used in addition checks against its own rule set and is independent of it.

Default: WCAG2AA
Default AI model for audit analyses (auditDefaultTextModel, string): A model identifier, for example Anthropic. If a model is set here, the model selection in the audit form is skipped. If the field stays empty, editors choose per run themselves.

Default: empty

Since versions 14.5.0/13.17.0/12.23.0 the extension settings are grouped into categories and subcategories. The settings themselves stayed the same.

Language Assignment (Locale Mapping)

In some TYPO3 installations, the language codes stored in the site configuration do not match the language codes that are ultimately to be transmitted to the connected AI services (e.g., DeepL, Google Translate, or ChatGPT).

Through the optional configuration aiSuite.locales in the config.yaml of your site, you can define a mapping that maps the TYPO3 language code to the desired target locale since versions 12.17.2/13.11.2.

Add the following block to your site configuration (config/sites/<identifier>/config.yaml):

aiSuite:
locales:
en: en-GB
…

On the left is the TYPO3 language code (ISO 639-1, e.g., en, de, fr), on the right the locale that is to be transmitted to the AI services.