Description
This plugin by Zactonz Technologies adds OpenRouter as an AI provider for the WordPress AI Client. It is built for the WordPress Settings > Connectors screen and for the plugin directory connector search, so a site owner who needs OpenRouter can find it, install it, paste a key, and have every AI feature in WordPress start using it.
OpenRouter is a routing gateway that exposes hundreds of models from dozens of labs behind one OpenAI-compatible API and one bill. This connector brings that catalogue into WordPress: every model your key can reach is discovered automatically, with vision, tool calling, and structured output detected per model from the OpenRouter catalogue rather than guessed.
Disclaimer: this connector is developed by Zactonz Technologies and is not affiliated with, endorsed by, or sponsored by OpenRouter. OpenRouter is a trademark of OpenRouter, Inc.
Features:
- Text generation with every OpenRouter chat model your credentials can reach
- Automatic model discovery, taking each model’s capabilities from the provider’s own catalogue wherever it publishes them
- Separate default model per capability, or automatic selection by the WordPress AI Client
- Vision input on models that accept images
- Tool calling on models that report function support
- Structured output with a JSON schema on models that support it
- Reasoning effort control for the default text model
- Cancellable server-sent event streaming for content, reasoning, and tool-call chunks
- A configurable request timeout for text generation
- API key supplied by a PHP constant or an environment variable instead of the database
- An API base URL override for a proxy or a private gateway
- Redacted diagnostics and a WordPress Site Health connectivity test
Requirements:
- PHP 7.4 or higher
- WordPress 7.0 or higher
- An OpenRouter account and API key
External services
This plugin sends requests to OpenRouter, a third-party service, and does nothing without it. Requests go to the OpenRouter API at https://openrouter.ai/api/v1, or to the API base URL you set in the connector settings.
What is sent and when: the API key you configure, and the prompts, images, tool definitions and generation settings that a WordPress AI feature passes to the AI Client, each time such a feature runs a request through this connector. The connector also requests the model catalogue when its settings screen loads, when a WordPress AI feature asks which models are available, and when you run diagnostics or the Site Health test. It also sends your site URL and site name in the HTTP-Referer and X-Title headers OpenRouter uses for attribution, so requests appear under your site in the OpenRouter activity view. No other data is sent.
Service provider: OpenRouter (terms of service, privacy policy).
Installation
- Upload the plugin files to
/wp-content/plugins/zactonz-ai-connector-for-openrouter/, or install the plugin through the WordPress plugins screen. - Activate the plugin through the Plugins menu in WordPress.
- Go to Settings > Connectors and add your OpenRouter API key.
- Go to Settings > OpenRouter to review the discovered models and choose a default model per capability.
FAQ
-
Where do I get an API key?
-
Create one on the OpenRouter dashboard: https://openrouter.ai/keys
-
Can I keep the key out of the database?
-
Yes. Define
OPENROUTER_API_KEYinwp-config.php, or set an environment variable of the same name. When either is present the connector uses it, the settings field is disabled, and nothing is written to the database. -
Which models will I see?
-
Models are listed from the OpenRouter catalogue your API key can reach. Each model is offered as vision, tool-calling or structured-output capable according to what OpenRouter publishes about it, and the connector falls back to the model identifier only where OpenRouter publishes nothing.
-
Does this replace the connectors in WordPress core?
-
No. WordPress core ships its own connectors. This plugin adds OpenRouter alongside them, and you can keep several connectors active at once and pick a default model per capability.
-
Is my key ever displayed or logged?
-
No. The key is stored in its own option, is never rendered back into the settings screen, and is excluded from the diagnostics report and from Site Health debug information.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Zactonz AI Connector for OpenRouter” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Zactonz AI Connector for OpenRouter” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.1
- Fixed the feature list promising request timeouts for embeddings and images. This connector offers neither, and only the text timeout exists.
- Fixed a model the provider marks inactive being offered, and sorted ahead of the rest, so a site with no default set could pick one that no longer serves traffic.
- Fixed a callback that throws on the final stream event escaping raw instead of the wrapped error every other path reports.
- Changed the model discovery wording, which claimed capabilities are read from the provider rather than guessed. Where a provider publishes no per-model capability data the connector falls back to inference, so the claim was not true everywhere.
- Fixed the model-discovery answer in the FAQ, which described capability detection for embeddings this connector does not offer, and repeated the discovery claim corrected above.
- Fixed the settings screen reporting no saved API key, and hiding the control that removes it, on a site where AI support is switched off. The key is read back from the AI Client, which WordPress only populates while it is wiring connectors.
1.0.0
- Initial release.
- Registers OpenRouter with the WordPress AI Client and the Settings > Connectors screen.
- Discovers models from the provider and advertises only the capabilities the provider reports.
- Adds per-capability default model selection, reasoning effort, a configurable timeout, and an API base URL override.
- Streams text responses token by token through the WordPress HTTP API, aggregating content, reasoning, tool calls, and usage.
- Adds a redacted diagnostics report and a WordPress Site Health connectivity test.
- Supports an API key supplied by a PHP constant or an environment variable.