mittwald AI Provider for WordPress

Warning

This plugin is experimental and not (yet) recommended for production usage.

A WordPress plugin that integrates mittwald AI Hosting with WordPress AI features, enabling AI-powered features on your WordPress site using mittwald's infrastructure.

About

This plugin provides a mittwald provider implementation for WordPress AI features, allowing you to leverage mittwald's AI hosting platform.

To actually use the connector, you need a plugin that makes use of the AI connector. The Plugin AI Experiments is the official example.

Credit: This provider implementation is forked from the OpenAIProvider in php-ai-client and adapted for mittwald's AI hosting platform, which uses an OpenAI-compatible API.

Requirements

• WordPress 7.0 or higher
• A mittwald AI Hosting account with API access
• WordPress AI Experiments Plugin (optional)

Installation

Install this plugin:

• Download this plugin from the WordPress plugin directory as a ZIP file
• Upload to WordPress
  • Navigate to "Plugins" → "Add New" (/wp-admin/plugin-install.php) and click "Upload Plugin".
  • Choose the downloaded ZIP file and click "Install Now".
• Activate the Plugin

Alternatively, use the WP CLI to install this plugin:

$ wp plugin install --activate mittwald-ai-provider`

Configuration

1. Obtain an API Key: Follow the mittwald AI Hosting access guide to get your API credentials.
2. Store AI Client Credentials (choose one):

   • In WordPress admin:

     • Navigate to Settings > Connectors (/wp-admin/options-connectors.php)
     • Fill in the mittwald API key and save

   • In wp-config.php via WP-CLI:

     $ wp config set MITTWALD_API_KEY your-api-key

   • In wp-config.php via direct file edit:

     define( 'MITTWALD_API_KEY', 'your-api-key' );

   • As environment variable (for example in Apache config):

     SetEnv MITTWALD_API_KEY your-api-key

3. Enable AI experiments (optional):
   • To actually use the connector, you need a plugin that makes use of the AI connector. The Plugin AI Experiments is the official example. Install and activate the plugin.
   • Navigate to Settings > AI Experiments (/options-general.php?page=ai-experiments)
   • Select »Enable Experiments« and Save
   • Select the Experiments you want to use and Save

Supported Operations & Models

Chat Completions ✅

Fully supported for conversational AI, content generation, and chat-based interactions.

Available Models:

• GPT-OSS models: Open-source GPT-compatible models

• Qwen: Qwen 3.5 122B-FP8 and Qwen 3.6 35B-FP8 (supports vision/image input)

• Ministral: supports vision/image input

• Devstral: optimized for code generation

• Capabilities:

• Standard text chat

• Image vision (Mistral Small and Qwen models)

• JSON output formatting

• Tool/function calling

• Streaming responses

Embeddings ⏸️

Not currently implemented.

Text to Image ⏸️

Not currently supported by mittwald AI Hosting.

Text to Speech ⏸️

Not currently supported by mittwald AI Hosting.

Speech to Text / Audio Transcription ⏸️

Not currently implemented.

Moderation ⏸️

Not currently supported by mittwald AI Hosting.

Rate Limits & Quotas

mittwald AI Hosting has usage limits based on your account tier. For details on usage limits and terms, see the mittwald AI Hosting terms of use.

Resources

• mittwald AI Hosting Documentation: https://developer.mittwald.de/docs/v2/platform/aihosting/
• API Access Guide: https://developer.mittwald.de/docs/v2/platform/aihosting/access-and-usage/access/
• Terms of Use: https://developer.mittwald.de/docs/v2/platform/aihosting/access-and-usage/terms-of-use/
• Drupal AI Module: https://www.drupal.org/project/ai

Development

Coding Standards

• Follows WordPress coding standards
• No debugging statements allowed in commits

Contributing

Contributions are welcome! Areas where help is especially appreciated:

• Adding tests
• Documentation improvements
• Bug fixes and performance improvements

To build an installable development version from source, run the package composer script:

$ composer run package

This command will create a ZIP file in the project directory that can be uploaded to a WordPress installation.

License

GPL-2.0-or-later

Support

For issues related to:

• This plugin: Open an issue in this repository
• mittwald AI Hosting: See mittwald documentation
• WordPress AI Experiments Plugin: See the project page