Razhur Connector for AvalAI

Razhur Connector for AvalAI adds AvalAI (https://avalai.ir) as a selectable AI provider for the WordPress AI system that ships with WordPress 7.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.

1.0.14

• Added a "Settings" link to the plugin row on the Plugins screen, and a plugin homepage link.

1.0.13

• Fixed: the API key could be cleared after a transient network/TLS error when WordPress re-validated the connector. The availability check now only marks the key invalid on an explicit 401/403 from the server, and preserves it on temporary network failures.

1.0.12

• Replaced generic prefixes with a distinct plugin-specific prefix to avoid conflicts: the namespace is now Razhur\AvalAiConnector, and all option names and filter hooks use the razhur_avalai_ prefix.

1.0.11

• Renamed the plugin to "Razhur Connector for AvalAI" with a distinctive, non-affiliated name and added a non-affiliation notice. Improved boolean setting sanitization (rest_sanitize_boolean) and corrected the contributor username.

1.0.10

• Compliance fixes for the WordPress.org Plugin Directory: escape exception output, remove the discouraged load_plugin_textdomain() call (translations are loaded automatically), add direct-file-access protection to the autoloader, and rewrite the readme in English.

1.0.9

• Removed the duplicate Plugin URI header (it matched the Author URI) and prepared the plugin for submission, including an "External services" disclosure section.

1.0.8

• Updated the plugin descriptions so AvalAI is correctly presented as a gateway to many different AI models.

1.0.7

• Fixed: saving the plugin settings no longer clears the connector API key (settings now use a dedicated settings group).
• Improved model classification using the "mode" field returned by AvalAI, so all image models appear correctly in the image model list.

1.0.6

• The plugin is now fully translatable. Added a translation template (POT) and a complete Persian (fa_IR) translation.

1.0.5

• Image optimization is now an option in the settings (enabled by default), with a warning about large images when disabled.
• Generated image file names are now created in English (ASCII). Filter: razhur_avalai_image_filename.

1.0.4

• Added a default image aspect ratio setting. The selected ratio (1:1, 3:2, 2:3, 16:9, 9:16) is sent as the size parameter with every image request, with an optional prompt-text hint. Filter: razhur_avalai_image_size.

1.0.3

• Added per-task model selection (text, image, vision) on the AvalAI settings page; each list shows only relevant models. Applied through the wpai_preferred_text_models, wpai_preferred_image_models and wpai_preferred_vision_models filters, without modifying the core AI plugin.

1.0.2

• Added automatic optimization of AI-generated images on import (downscale to a maximum of 1536px and convert to WebP), while WordPress still generates all responsive sizes. Filters: razhur_avalai_optimize_images, razhur_avalai_image_max_dimension, razhur_avalai_image_quality, razhur_avalai_image_mime.

1.0.1

• Fixed "cURL error 28: Operation timed out" errors (especially for image generation) by setting an adequate request timeout. Filter: razhur_avalai_request_timeout.

1.0.0

• Initial release. Adds AvalAI as an AI provider with access to many different models and a configurable API base URL.