A connector plugin that registers AvalAI as an AI provider for WordPress. Once connected, the built-in WordPress AI features work through AvalAI — a single gateway that gives you access to many different AI models for text and image generation.
WordPress 7.0 ships with a built-in AI system. This plugin adds AvalAI as a selectable provider for that system — exactly like the official OpenAI and Google connector plugins. No changes to the core AI plugin are needed; every existing AI feature simply starts working through AvalAI.
Everything you need to run WordPress AI through AvalAI — efficiently and on your terms.
Registers AvalAI with the WordPress AI Client so it appears alongside other providers, with no core changes.
Access many text and image models through one gateway. The model lists are fetched live from AvalAI.
Pick a dedicated model for text, image, and vision tasks. Each list only shows models that support that task — so you never pay for the wrong one.
Set a default image ratio (1:1, 3:2, 2:3, 16:9, 9:16) sent automatically with every image request, with an optional prompt-text hint.
Heavy AI-generated PNGs are downscaled and converted to WebP on import — keeping pages fast. A real test reduced a 6.9 MB image to ~44 KB. Fully optional.
Choose between AvalAI's two API endpoints, or enter a custom base URL — handy if one is unreachable from your server.
Generated images get tidy ASCII filenames instead of long non-Latin names derived from the prompt.
The API key is stored through the WordPress AI settings page and masked in REST responses. No front-end output, no external links on your public site.
Fully internationalized, shipping with English and a complete Persian (fa_IR) translation. Switch your admin language and the UI follows.
Four simple steps and your WordPress AI features run on AvalAI.
Upload the plugin and activate it from the Plugins screen.
Go to Settings → AvalAI and select the API base URL (primary or mirror).
Enter your AvalAI API key on the WordPress AI settings page. Get a key at ava.al/keys.
Optionally choose a model and aspect ratio per task, then start generating.
A look at the plugin's settings and the AI features in action.
Sensible defaults out of the box, with settings for everything that matters.
Primary or mirror endpoint (or a custom URL). API key managed on the WordPress AI page, or via the AVALAI_API_KEY constant.
Separate model choice for text, image and vision — applied through standard WordPress filters, so the core plugin stays untouched.
Filters for timeout, image size, optimization, output format and filenames let developers fine-tune behavior.
To provide AI features, the plugin communicates with the AvalAI API at
https://api.avalai.ir/v1 or https://api.avalapis.ir/v1 (selectable in settings).
Your prompt content — and, where relevant, images — together with your API key are sent to AvalAI only when you (or an AI feature) run a generation request, plus a request to list models and validate the key.
The plugin adds no front-end output and no external links on your public site. Use of AvalAI is subject to its terms and privacy policy — see avalai.ir and docs.avalai.ir.
On the WordPress AI settings page, next to other providers. It is stored in the
connectors_ai_avalai_api_key option, or can be provided via the
AVALAI_API_KEY constant/environment variable.
Go to Settings → AvalAI and pick the primary or mirror endpoint, or enter a custom URL.
Advanced setups can fix it with the AVALAI_BASE_URL constant.
Yes. Under Settings → AvalAI you can select a dedicated model for text, image and vision tasks. Each list only shows models that support that task, so you can pick a cheaper or faster model and avoid unexpected costs.
No. AI images are automatically downscaled and converted to WebP on import (this can be turned off in settings), while WordPress still generates all responsive sizes.
Yes — it uses the same WordPress AI provider framework, so it behaves as a drop-in provider and all existing AI features keep working.