About this plugin
0. AvalAI is an AI gateway (similar to OpenRouter) that gives you access to many different AI models — such as GPT, Gemini, Claude, Flux, Imagen and Qwen — through a single unified API.
Once activated and configured with your AvalAI API key, AvalAI appears alongside the other providers on the WordPress AI settings page, and every built-in AI feature simply works through AvalAI. No changes to the core AI plugin are required; this plugin behaves as a drop-in provider, exactly like the official OpenAI and Google connector plugins.
This is an independent, third-party plugin developed by Razhur. It is not affiliated with, endorsed by, or sponsored by AvalAI. “AvalAI” is used only to identify the service this plugin connects to.
Features
- Drop-in AI provider — registers AvalAI with the WordPress AI system; no core changes needed.
- Many models — access a large set of text and image models, fetched live from AvalAI.
- Per-task model selection — choose a dedicated model for text generation, image generation and vision (image understanding). Each list shows only the models that support that task, so you can pick a cheaper or faster model and avoid unexpected cost.
- Default aspect ratio — set a default image ratio (1:1, 3:2, 2:3, 16:9, 9:16) that is sent with every image request, with an optional prompt-text hint for models that ignore the size parameter.
- Automatic image optimization — large AI-generated PNG images are downscaled and converted to WebP on import to keep pages fast, while WordPress still generates all responsive sizes. This is optional and can be turned off.
- Clean English file names — generated images are saved with tidy ASCII file names instead of long names derived from the prompt.
- Selectable API endpoint — choose between the two AvalAI endpoints, or enter a custom base URL.
- Secure key handling — the API key is stored through the WordPress AI settings page and masked in REST responses.
- Translation ready — fully internationalized, shipping with English and a complete Persian (fa_IR) translation.
Supported AI features
- Content generation
- Article generation
- Content rewriting
- Image generation (including featured images)
- Vision / alt text generation
- Other AI-assisted workflows provided by the WordPress AI system
API endpoints
AvalAI provides two equivalent endpoints; either can be selected in the settings:
- https://api.avalai.ir/v1 (primary, default)
- https://api.avalapis.ir/v1 (mirror)
Requirements
- WordPress 7.0 or higher (the AI Client SDK is bundled in WordPress 7.0 core).
- PHP 7.4 or higher.
- An AvalAI API key.
External services
This plugin connects to the external service AvalAI to provide its AI features. Without connecting to this service, the plugin does nothing.
- What is sent: when you (or an AI feature) run a generation request, your prompt content — and, where relevant, images — together with your API key are sent to AvalAI. A request is also made to list the available models and to validate the API key.
- When it is sent: only when an AI request is performed, and when listing/validating models on the settings page.
- Where it is sent: to the AvalAI API at https://api.avalai.ir/v1 or https://api.avalapis.ir/v1 (selectable in settings).
- The plugin adds no front-end output and no external links on the public site.
Use of this service is subject to AvalAI’s terms and privacy policy:
- Website: https://avalai.ir
- Documentation and privacy policy: https://docs.avalai.ir/en/
Using this plugin requires an AvalAI account and API key.