Title: Razhur Connector for AvalAI Author: arashmoradi99 Published: 17 Juni 2026 Last modified: 18 Juni 2026 --- Cari plugin ![](https://ps.w.org/razhur-connector-for-avalai/assets/banner-772x250.png?rev=3576767) ![](https://ps.w.org/razhur-connector-for-avalai/assets/icon-256x256.png?rev=3576767) # Razhur Connector for AvalAI Oleh [arashmoradi99](https://profiles.wordpress.org/arashmoradi99/) [Unduh](https://downloads.wordpress.org/plugin/razhur-connector-for-avalai.1.0.14.zip) * [Detail](https://id.wordpress.org/plugins/razhur-connector-for-avalai/#description) * [Ulasan](https://id.wordpress.org/plugins/razhur-connector-for-avalai/#reviews) * [Instalasi](https://id.wordpress.org/plugins/razhur-connector-for-avalai/#installation) * [Pengembangan](https://id.wordpress.org/plugins/razhur-connector-for-avalai/#developers) [Bantuan](https://wordpress.org/support/plugin/razhur-connector-for-avalai/) ## Deskripsi 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. ### 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. ## Tangkapan Layar [[ [[ [[ [[ ## Instalasi 1. Upload the plugin folder to `/wp-content/plugins/razhur-connector-for-avalai/`, or install it from the Plugins screen. 2. Activate the plugin through the “Plugins” menu in WordPress. 3. Go to **Settings -> AvalAI** and select the API base URL (primary or mirror). 4. Go to the WordPress AI settings page (**Settings -> AI**) and enter your AvalAI API key, or define it via the `AVALAI_API_KEY` constant or environment variable. You can obtain a key at https://ava.al/keys. 5. Optionally, use the “Model Selection” and “Image Options” sections on the AvalAI settings page to choose a model and a default aspect ratio per task. ## Tanya Jawab ### Where do I enter the API key? On the WordPress AI settings page, next to the other providers. The key is stored in the `connectors_ai_avalai_api_key` option, or it can be provided via the `AVALAI_API_KEY` constant or environment variable. ### How do I switch between the two AvalAI endpoints? Go to Settings -> AvalAI and choose the primary or mirror endpoint, or enter a custom URL. Advanced setups can fix it with the `AVALAI_BASE_URL` constant. ### My API key fails validation when I save it. The system validates the key by listing models against the configured base URL. Make sure the correct base URL is selected under Settings -> AvalAI and that your server can reach that endpoint, then save the key again. ### Can I choose which model is used? 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. ### Will generated images slow down my site? No. AI-generated images are automatically downscaled and converted to WebP on import( this can be disabled in settings), while WordPress still generates all responsive image sizes. ### Does optimization affect normal media uploads? No. Image optimization only applies to images created through the WordPress AI system, not to regular media uploads. ## Ulasan ![](https://secure.gravatar.com/avatar/83f778b76242cadf3ab84242b585811973f8729a9b0864b15eff203814ff445e? s=60&d=retro&r=g) ### 󠀁[Just what I needed](https://wordpress.org/support/topic/just-what-i-needed-1401/)󠁿 [aminvalipoor1234](https://profiles.wordpress.org/aminvalipoor1234/) 18 Juni 2026 I’ve been using this plugin for a while, and it’s been a game-changer for my content strategy. The integration with AI is seamless, and the quality of the generated content is surprisingly high. It’s user-friendly, fast, and saves me hours of work every week. Highly recommended for anyone looking to scale their WordPress site! [ Baca semua 1 ulasan ](https://wordpress.org/support/plugin/razhur-connector-for-avalai/reviews/) ## Kontributor & Pengembang “Razhur Connector for AvalAI” adalah perangkat lunak open source. Berikut ini mereka yang sudah berkontribusi pada plugin ini. Kontributor * [ arashmoradi99 ](https://profiles.wordpress.org/arashmoradi99/) [Terjemahkan “Razhur Connector for AvalAI” dalam bahasa Anda.](https://translate.wordpress.org/projects/wp-plugins/razhur-connector-for-avalai) ### Tertarik mengembangkan? [Lihat kode](https://plugins.trac.wordpress.org/browser/razhur-connector-for-avalai/), periksa [repositori SVN ](https://plugins.svn.wordpress.org/razhur-connector-for-avalai/), atau mendaftar ke [log pengembangan](https://plugins.trac.wordpress.org/log/razhur-connector-for-avalai/) melalui [RSS](https://plugins.trac.wordpress.org/log/razhur-connector-for-avalai/?limit=100&mode=stop_on_copy&format=rss). ## Log Perubahan #### 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. ## Meta * Versi **1.0.14** * Diperbarui **4 bulan yang lalu** * Instalasi Aktif **Kurang dari 10** * Versi WordPress ** 7.0 atau yang terbaru ** * Diuji hingga **7.0.7** * Versi PHP ** 7.4 atau yang terbaru ** * Bahasa * [English (US)](https://wordpress.org/plugins/razhur-connector-for-avalai/) * Tag * [AI](https://id.wordpress.org/plugins/tags/ai/)[connector](https://id.wordpress.org/plugins/tags/connector/) [gateway](https://id.wordpress.org/plugins/tags/gateway/)[image-generation](https://id.wordpress.org/plugins/tags/image-generation/) * [Tampilan lanjut](https://id.wordpress.org/plugins/razhur-connector-for-avalai/advanced/) ## Rating 5 dari 5 bintang. * [ 1 ulasan 5-bintang ](https://wordpress.org/support/plugin/razhur-connector-for-avalai/reviews/?filter=5) * [ 0 ulasan 4-bintang ](https://wordpress.org/support/plugin/razhur-connector-for-avalai/reviews/?filter=4) * [ 0 ulasan 3-bintang ](https://wordpress.org/support/plugin/razhur-connector-for-avalai/reviews/?filter=3) * [ 0 ulasan 2-bintang ](https://wordpress.org/support/plugin/razhur-connector-for-avalai/reviews/?filter=2) * [ 0 ulasan 1-bintang ](https://wordpress.org/support/plugin/razhur-connector-for-avalai/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/razhur-connector-for-avalai/reviews/#new-post) [Lihat semua ulasan](https://wordpress.org/support/plugin/razhur-connector-for-avalai/reviews/) ## Kontributor * [ arashmoradi99 ](https://profiles.wordpress.org/arashmoradi99/) ## Bantuan Ada yang ingin dikatakan? Butuh bantuan? [Lihat forum bantuan](https://wordpress.org/support/plugin/razhur-connector-for-avalai/)