Title: AI Provider for OpenCode Zen – Multi-Model LLM Connector Author: Al Amin Ahamed Published: 2026년 4월 30일 Last modified: 2026년 9월 11일 --- 플러그인 검색 ![](https://ps.w.org/alamin-ai-provider-for-opencode-zen/assets/banner-772x250.png? rev=3519300) ![](https://ps.w.org/alamin-ai-provider-for-opencode-zen/assets/icon.svg?rev=3519300) # AI Provider for OpenCode Zen – Multi-Model LLM Connector 작성자: [Al Amin Ahamed](https://profiles.wordpress.org/mralaminahamed/) [다운로드](https://downloads.wordpress.org/plugin/alamin-ai-provider-for-opencode-zen.1.6.0.zip) [실시간 미리보기](https://ko.wordpress.org/plugins/alamin-ai-provider-for-opencode-zen/?preview=1) * [세부사항](https://ko.wordpress.org/plugins/alamin-ai-provider-for-opencode-zen/#description) * [평가](https://ko.wordpress.org/plugins/alamin-ai-provider-for-opencode-zen/#reviews) * [설치](https://ko.wordpress.org/plugins/alamin-ai-provider-for-opencode-zen/#installation) * [개발](https://ko.wordpress.org/plugins/alamin-ai-provider-for-opencode-zen/#developers) [지원](https://wordpress.org/support/plugin/alamin-ai-provider-for-opencode-zen/) ## 설명 This plugin is an AI connector for [OpenCode Zen](https://opencode.ai). It registers OpenCode Zen with the WordPress AI Client, so every AI-enabled plugin on your site can reach 61 large language models through one API key — GPT, Claude, Gemini, Grok, Qwen, DeepSeek, MiniMax, Kimi and more, with no separate account per vendor. This plugin is an independent, third-party integration and is not affiliated with, endorsed by, or sponsored by OpenCode Zen. #### Why OpenCode Zen? OpenCode Zen is an **AI model aggregator** — one API key gives you access to 61 frontier models from OpenAI, Anthropic, Google, and others. Instead of managing separate API keys and billing accounts for each AI provider, you connect once to OpenCode Zen and switch between models freely. This makes it ideal for WordPress sites that want to experiment with different AI models, compare output quality, or use specialised models (e.g. a coding model for code-related tasks and a creative model for content). #### Features * **61 models from one API key** — GPT 5.x, Claude, Gemini 3.x, Qwen, MiniMax, Kimi, Grok, DeepSeek, and more * **Automatic model discovery** — live model list fetched from the OpenCode Zen API and cached hourly; falls back to a hardcoded list when offline * **Full parameter control** — temperature, max tokens, top P, presence penalty, frequency penalty, stop sequences, system instruction, and function declarations * **Chat history** — multi-turn conversations, not just single prompts * **Settings page** — configure default model and generation parameters without touching code * **API key via Connectors** — enter your key once in **Settings > Connectors**; all AI-enabled plugins share it automatically * **Environment variable support** — `OPENCODE_ZEN_API_KEY` for server-level configuration, bypassing the database entirely * **OpenAI-compatible API** — built on the same protocol as OpenAI, so any model that works with the OpenAI provider works here * **No vendor lock-in** — switch between GPT, Claude, and Gemini without changing plugin or configuration #### What Can You Do With AI in WordPress? Once this provider is configured, any WordPress plugin or theme that integrates with the WordPress AI Client can use it: * **Block editor (Gutenberg)** — AI writing assistance, rephrasing, summarising, and expanding content * **WooCommerce** — AI-generated product descriptions, SEO meta titles, and customer review summaries * **SEO plugins** — generate meta descriptions, focus keyphrases, and Open Graph content * **Customer support** — power AI chatbots and FAQ auto-responses * **Translation and localisation** — translate and adapt content for different markets * **Code generation** — use a coding-specialised model (GPT 5.3 Codex, Grok Build) directly in the editor * **Image alt text** — generate accessible alt attributes for media library images #### Supported Models The live model list is fetched directly from the OpenCode Zen API, so you always see the latest models — no API key needed to read the catalogue. If the API is ever unavailable, a built-in fallback list of 61 models keeps everything working. Families include: * **GPT 5.x** — Sol, Terra, Luna, plus Pro, Mini, Nano, and Codex variants * **Claude** — Fable 5, Opus 4.x, Sonnet 5 / 4.x, Haiku 4.5 * **Gemini 3.x** — Flash, Flash Lite, and Pro * **More** — Grok, Qwen, DeepSeek, MiniMax, GLM, Kimi, and free-tier models See the [full model catalogue](https://github.com/mralaminahamed/ai-provider-for-opencode-zen/blob/trunk/docs/MODELS.md) for every model ID. #### Requirements * PHP 7.4 or higher * WordPress 7.0 or higher * An [OpenCode Zen](https://opencode.ai) account and API key #### How the WordPress AI Provider System Works WordPress 7.0 introduced a built-in AI Client SDK. Plugins and themes call a standard API (e.g. “generate text from this prompt”) without knowing which AI provider is active. Provider plugins like this one register themselves with WordPress and handle the actual API calls. This means: 1. Install this plugin OpenCode Zen is registered as an AI provider 2. Enter your API key in **Settings > Connectors** 3. Every AI-enabled plugin on your site can now use OpenCode Zen automatically You can also install multiple provider plugins and switch between them from the Connectors screen — no re-configuration of individual plugins needed. #### Settings Go to **Settings > OpenCode Zen** to configure: * **Default Model** — the model used when no explicit model is requested by a plugin * **Temperature** — controls output randomness (0.0–2.0, default 0.7) * **Max Tokens** — maximum tokens in the response (1–200,000, default 4096) * **Top P** — nucleus sampling threshold (0.0–1.0, default 1.0) * **Presence Penalty** — penalises repeated topics (-2.0–2.0, default 0.0) * **Frequency Penalty** — penalises repeated tokens (-2.0–2.0, default 0.0) #### For Developers This plugin follows the official WordPress AI Provider pattern and works with any plugin built on the WordPress AI Client SDK. It registers the `opencode-zen` provider and supports the standard generation options (temperature, max tokens, top P, presence/ frequency penalties, stop sequences, system instruction, and function declarations). The source code is on GitHub — bug reports and pull requests are welcome: * Repository: [github.com/mralaminahamed/ai-provider-for-opencode-zen](https://github.com/mralaminahamed/ai-provider-for-opencode-zen) * Report a bug or request a feature: [open a new issue](https://github.com/mralaminahamed/ai-provider-for-opencode-zen/issues/new) * Contribute code: [submit a pull request](https://github.com/mralaminahamed/ai-provider-for-opencode-zen/pulls) Developer documentation: * [Usage and code examples](https://github.com/mralaminahamed/ai-provider-for-opencode-zen/blob/trunk/docs/USAGE.md) * [Architecture and API key resolution](https://github.com/mralaminahamed/ai-provider-for-opencode-zen/blob/trunk/docs/ARCHITECTURE.md) * [Development and contributing](https://github.com/mralaminahamed/ai-provider-for-opencode-zen/blob/trunk/docs/DEVELOPMENT.md) #### More from us Other free plugins by the same author, all on WordPress.org. **Another provider for the same AI Client** * [AI Provider for MiniMax](https://wordpress.org/plugins/alamin-ai-provider-for-minimax/)– MiniMax M2 and M3 models for text generation, for the WordPress AI Client. **For any site** * [Swift Menu Duplicator](https://wordpress.org/plugins/swift-menu-duplicator/)– Duplicate menus in one click, snapshot revisions, export and import, WP-CLI and REST. * [Author Profile Blocks](https://wordpress.org/plugins/author-profile-blocks/)– Author and team profiles as Gutenberg blocks — grid, carousel, list and single. **For a WooCommerce store** * [StoreSeeder](https://wordpress.org/plugins/storeseeder/) – Realistic test data for WooCommerce and Fluent Cart — a whole shop from a recipe, with one-click cleanup. * [StoreSheet](https://wordpress.org/plugins/storesheet/) – Sync WooCommerce products, orders and coupons to a Google spreadsheet, one way and in the background. ### External Services This plugin connects to the **OpenCode Zen API** (`https://opencode.ai/zen/v1`) to: 1. Retrieve the list of available AI models (cached for 1 hour via WordPress transients) 2. Send text generation requests using your configured model **Service:** OpenCode Zen **API endpoint:** `https://opencode.ai/zen/v1` **When data is sent:** When generating AI text or refreshing the model list **Data sent:** Your API key (via Authorization header) and the text prompt/conversation **Provider site:** [opencode.ai](https://opencode.ai/) — refer to the OpenCode Zen website for their current Terms of Service and Privacy Policy. No data is sent to the OpenCode Zen API until you enter an API key and a WordPress feature triggers a text generation request. ## 설치 1. Upload the plugin files to `/wp-content/plugins/alamin-ai-provider-for-opencode- zen/`. 2. Activate the plugin through the **Plugins** menu in WordPress. 3. Go to **Settings > Connectors** and enter your OpenCode Zen API key. 4. Go to **Settings > OpenCode Zen** to choose a default model and tune generation parameters. 5. Install any AI-enabled plugin (e.g. the [AI Experiments](https://wordpress.org/plugins/ai/) plugin) to start using AI features. #### Getting Your API Key 1. Sign up at [opencode.ai](https://opencode.ai) 2. Go to [opencode.ai/zen/settings/api-keys](https://opencode.ai/zen/settings/api-keys) 3. Create a new API key and copy it 4. Paste it into **Settings > Connectors** in your WordPress admin #### WP-CLI Installation ``` wp plugin install alamin-ai-provider-for-opencode-zen --activate ``` ## FAQ ### What is OpenCode Zen? OpenCode Zen is an AI platform that acts as a gateway to multiple AI providers. Instead of needing separate API keys for OpenAI (GPT), Anthropic (Claude), and Google( Gemini), you get access to all of them through a single OpenCode Zen API key. Learn more at [opencode.ai](https://opencode.ai). ### Where do I enter my API key? Go to **Settings > Connectors** in your WordPress admin and enter your OpenCode Zen API key there. All AI-enabled plugins on your site will automatically use it. Alternatively, set the `OPENCODE_ZEN_API_KEY` environment variable on your server. ### Do I need to install a separate AI Client plugin? No. WordPress 7.0 and higher include the AI Client SDK natively — no additional plugin is required. ### Which model should I choose as the default? It depends on your use case: * **Content writing** — Claude Sonnet 4.6 or GPT 5.4 for natural, fluent prose * **Coding tasks** — GPT 5.3 Codex or Grok Build 0.1 for code generation and review * **Speed/cost balance** — GPT 5.4 Mini or Gemini 3 Flash for quick, low-cost tasks * **Research/analysis** — Claude Opus 4.x or GPT 5.5 Pro for depth and accuracy ### What happens if the OpenCode Zen API is unreachable? The plugin falls back to a hardcoded list of 61 models so the AI Client continues to function and AI-enabled plugins stay operational. ### Can I use multiple AI provider plugins at the same time? Yes. WordPress lets you install multiple provider plugins. You can switch the active provider from **Settings > Connectors** at any time without reconfiguring any plugin. ### Is my API key stored securely? Your API key is stored in the WordPress options table, which is protected by your database credentials. For higher security, set the `OPENCODE_ZEN_API_KEY` environment variable on your server — this keeps the key entirely out of the database. ### How does billing work? Billing is handled entirely by OpenCode Zen. Your usage is billed according to [OpenCode Zen’s pricing](https://opencode.ai) based on tokens consumed per model. WordPress and this plugin do not charge anything. ### What generation parameters does this provider support? Temperature, max tokens, top P, presence penalty, frequency penalty, stop sequences, system instruction, and function declarations — the full set of options supported by the WordPress AI Client SDK. ### Can I use this for WooCommerce product descriptions? Yes, if you have a WooCommerce plugin that integrates with the WordPress AI Client. Once this provider is active and your API key is set, any AI-enabled WooCommerce plugin can generate product descriptions, SEO meta, and more using any of the 61 models. ### Does this work with the Gutenberg block editor? Yes. Any Gutenberg plugin or block that uses the WordPress AI Client will automatically use this provider once configured. ### Do you have a developer API? This plugin implements the standard WordPress AI Client provider interface. Developers building plugins or themes on top of the WordPress AI Client do not need to do anything special — if this provider is active, it will be available automatically. ## 후기 이 플러그인에 대한 평가가 없습니다. ## 기여자 & 개발자 “AI Provider for OpenCode Zen – Multi-Model LLM Connector”(은)는 오픈 소스 소프트웨어입니다. 다음의 사람들이 이 플러그인에 기여하였습니다. 기여자 * [ Al Amin Ahamed ](https://profiles.wordpress.org/mralaminahamed/) [자국어로 “AI Provider for OpenCode Zen – Multi-Model LLM Connector”(을)를 번역하세요.](https://translate.wordpress.org/projects/wp-plugins/alamin-ai-provider-for-opencode-zen) ### 개발에 관심이 있으십니까? [코드 탐색하기](https://plugins.trac.wordpress.org/browser/alamin-ai-provider-for-opencode-zen/) 는, [SVN 저장소](https://plugins.svn.wordpress.org/alamin-ai-provider-for-opencode-zen/) 를 확인하시거나, [개발 기록](https://plugins.trac.wordpress.org/log/alamin-ai-provider-for-opencode-zen/) 을 [RSS](https://plugins.trac.wordpress.org/log/alamin-ai-provider-for-opencode-zen/?limit=100&mode=stop_on_copy&format=rss) 로 구독하세요. ## 변경이력 #### 1.6.0 – 2026-09-12 **Added** – **A Test connection button** on the settings page. The page used to say “OpenCode Zen is connected” as soon as a key existed anywhere, without ever asking Zen — a revoked, mistyped or wrong-account key read as connected, and the first sign of trouble was a generation failing somewhere else. Zen’s model list is public and answers even to a nonsense key, so the check sends a one-token request to one of Zen’s own free-tier models. A network failure is reported as “could not be checked”, not as a bad key. The verdict is cached for five minutes and dropped whenever the key changes. – **An uninstall handler.** Deleting the plugin now removes the `opencode_zen_settings` option and the `opencode_zen_models_cache` transient, which it used to leave behind for good. Your API key is deliberately left alone: it belongs to the WordPress Connectors screen and, in the shared case, to every AI provider on the site. – **Image input on `deepseek-v4-flash-vision-exp`.** Without the declaration the AI Client will not route an image prompt to Zen at all, so the plugin was declining work it can do. Declared only where Zen documents it. **Changed** – The plugin autoloads its own classes and ships no `vendor/` directory. There was never a runtime dependency to justify Composer here. – The settings page no longer claims the provider is connected on the strength of a key existing. It says a key is configured, notes that this is not the same as one that works, and offers to check. – Re-synced the built-in fallback model catalogue with the live endpoint — **70 models**, up from 61. – Declared as tested against WordPress 7.1.– Directory listing copy: the title, tags and short description now say “connector” and lead with the model count, which is what people search for. **Fixed** – **The chosen default model now decides which model is used.** The setting has been stored since 1.0.0 and never read: picking one wrote a row to the database and changed no request that followed. With seventy models from eight vendors, what you got instead was a coin toss you had no say in. Nothing is filtered, so a caller that names another model still gets it. – **Generation requests are now addressed to OpenCode Zen.** The plugin returned a relative path where the AI Client expects an absolute URL, so every request named no host and could not be sent. – A copy installed from git no longer activates and silently does nothing. It used to look for Composer’s autoloader, find none, and return without registering a provider or saying why. #### 1.5.0 – 2026-08-09 **Added** – **Settings are now applied to requests.** Temperature, max tokens, top_p and the penalties had been stored since 1.0.0 and never read — nothing outside the settings class touched `opencode_zen_settings`, so saving the form changed a database row and nothing else. A caller’s own value still wins; the saved values fill in what was left unset. – `opencode_zen_generate_text_params` filter, which receives the model id — useful because Zen fronts several vendors and they do not all accept the same parameters. * **Custom options.** Arbitrary passthrough parameters, which the AI Client’s base class already merged into the request body but which no caller could reach, because the option was not declared. It matters more here than for a single-vendor provider: Zen fronts eight vendors, and a parameter only one of them understands has nowhere else to go. * **Chat history** — the models are now declared as supporting multi-turn conversations, not just single prompts. They always could (the endpoint takes a `messages` array and the AI Client already sends one), but the capability was never declared and the AI Client routes on the declaration, so conversation requests were going to other providers. Every official WordPress AI provider declares this. **Changed** – **PHP namespace is now `OpenCodeZen\OpenCodeZenAiProvider\`** (was` AlAminAhamed\OpenCodeZenAiProvider\`). – **Class names dropped their `OpenCodeZen` prefix**, which the namespace already carries: `OpenCodeZenProvider` is `Provider`,` OpenCodeZenSettings` is `Settings`, `OpenCodeZenModelMetadataDirectory` is `ModelMetadataDirectory`,` OpenCodeZenTextGenerationModel` is `TextGenerationModel`, and `OpenCodeZenProviderAvailability` is `ProviderAvailability`. – **The model list no longer requires an API key.** OpenCode Zen serves its catalogue publicly, and this plugin was returning early without a key — so a site saw the built-in fallback list at exactly the moment it was first being configured. The key is still sent when there is one. – Synced the built-in fallback list to the live catalogue: **61 models**, adding Claude Opus 5, Claude Sonnet 4, Kimi K3, Ling 3.0 Flash Free, Ling 3.0 Tiny Free and LongCat 2.0 Free. * **Restructured the bootstrap.** The plugin file is now an entry point — constants, autoloader, boot — and all wiring moved into an `AI_Provider_For_OpenCode_Zen` singleton in `class-ai-provider-for-opencode-zen.php`, so every hook the plugin registers is visible in one file. Matches the layout used across this author’s other plugins. * Added `OPENCODE_ZEN_VERSION`, `OPENCODE_ZEN_URL` and `OPENCODE_ZEN_PATH` constants; only `OPENCODE_ZEN_PLUGIN_FILE` existed before. Both renames are internal. No hook, option, setting or model id changes, and nothing a site has configured is affected — but any code referencing these classes directly needs updating. **Fixed** – Removed `qwen3.7-max` and `qwen3.7-plus`, which were offered in the model list and are not served by OpenCode Zen. Selecting either produced a failed generation rather than an invalid-setting warning. – The model directory no longer calls WordPress functions when running outside WordPress, which the class is documented to support. #### 1.4.0 – 2026-07-21 **Added** – Connection status on the settings page — shows whether an OpenCode Zen API key is configured, with a link to the Connectors screen. – “Connectors” quick link on the Plugins screen, next to Settings. **Changed** – Synced the built-in fallback model list to the current OpenCode Zen catalogue — now 54 models (added GPT 5.6 Sol/Terra/Luna, Claude Sonnet 5, Grok 4.5, DeepSeek V4 Pro/Flash, MiniMax M3, GLM 5.2/5, Kimi K2.7 Code, and free-tier models; removed the retired Claude 3.5 Haiku and Nemotron 3 Super Free). – A default model( GPT 5.5) is now pre-selected out of the box instead of an empty choice. **Fixed** – Autoloader collision with WordPress core’s bundled AI Client that could cause a TypeError on AI requests — the plugin no longer ships a conflicting copy of php-ai-client (WordPress core provides it at runtime). #### 1.3.1 – 2026-06-16 **Fixed** – API key stored via Settings > Connectors (`connectors_ai_opencode_zen_api_key`) now correctly used for live model list fetching — previously fell back to the hardcoded model list even when the Connectors key was set. – Settings `get_settings()` now returns all 6 default fields when the saved option is corrupt or missing; previously returned only `temperature` and `max_tokens`. **Changed** – Added Claude Fable 5 and Claude Opus 4.8 to the fallback model list( 42+ models total). #### 1.3.0 – 2026-06-16 **Added** – Top P, Presence Penalty, and Frequency Penalty settings fields on the admin settings page. – Full SupportedOptions coverage: temperature, top P, presence penalty, frequency penalty, stop sequences, system instruction, function declarations, and max tokens. **Changed** – Extracted all admin HTML markup to `templates/admin/` for cleaner separation of logic and presentation. – Renamed plugin class directory from `src/` to `includes/` per WordPress plugin conventions. – Removed AI Client SDK from Composer production dependencies — WordPress 7.0+ provides it natively at runtime. – Updated` Requires at least` to 7.0. #### 1.2.1 – 2026-05-01 **Fixed** – Connector showing as “Connected” before any API key is entered — provider availability now correctly checks for a configured API key. #### 1.2.0 – 2026-04-01 **Added** – Provider logo displayed on the WordPress Connectors page alongside Anthropic, Google, and OpenAI. – Expanded test suite from 37 to 48 tests covering all model families, provider logo path, and settings edge cases. **Fixed** – False “no valid connector” warning on the AI admin page when API key is set via the Connectors page. #### 1.1.0 – 2026-03-01 **Added** – Updated fallback model list from 4 stale models to 40+ current models( GPT 5.x, Claude 4.x, Gemini 3.x, Qwen, MiniMax, GLM, Kimi, Grok, and free-tier models).– Domain Path header field to plugin file. **Changed** – Improved plugin file header field ordering per WordPress.org standard.– Added file-level PHPDoc block to plugin bootstrap file. #### 1.0.0 – 2026-01-01 * Initial release. * OpenCode Zen provider registration with WordPress AI Client. * Dynamic model discovery with transient caching and fallback list. * Settings page for default model configuration. * Support for `OPENCODE_ZEN_API_KEY` environment variable. ## 기초 * 버전 **1.6.0** * 최근 업데이트: **4주 전** * 활성화된 설치 **10+** * 워드프레스 버전 ** 7.0 또는 그 이상 ** * 다음까지 시험됨: **7.1.3** * PHP 버전 ** 7.4 또는 그 이상 ** * 언어 * [English (US)](https://wordpress.org/plugins/alamin-ai-provider-for-opencode-zen/) * 태그: * [artificial intelligence](https://ko.wordpress.org/plugins/tags/artificial-intelligence/) [connector](https://ko.wordpress.org/plugins/tags/connector/)[LLM](https://ko.wordpress.org/plugins/tags/llm/) [opencode](https://ko.wordpress.org/plugins/tags/opencode/)[Text generation](https://ko.wordpress.org/plugins/tags/text-generation/) * [고급 보기](https://ko.wordpress.org/plugins/alamin-ai-provider-for-opencode-zen/advanced/) ## 평점 아직 제출된 리뷰가 없습니다. [Your review](https://wordpress.org/support/plugin/alamin-ai-provider-for-opencode-zen/reviews/#new-post) [모든 리뷰 보기](https://wordpress.org/support/plugin/alamin-ai-provider-for-opencode-zen/reviews/) ## 기여자 * [ Al Amin Ahamed ](https://profiles.wordpress.org/mralaminahamed/) ## 지원 할 말 있으신가요? 도움이 필요하신가요? [지원 포럼 보기](https://wordpress.org/support/plugin/alamin-ai-provider-for-opencode-zen/)