AI Provider for OpenCode Zen

This plugin provides OpenCode Zen integration for the WordPress AI Client. It enables WordPress sites to use OpenCode Zen’s AI gateway — accessing GPT, Claude, Gemini, Qwen, MiniMax, Kimi, and more through a single OpenAI-compatible API.

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 40+ 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

• 40+ models from one API key — GPT 5.x, Claude 4.x, 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
• 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

When an API key is configured, the live model list is fetched from the OpenCode Zen API. The built-in fallback list includes:

GPT models GPT 5.5, GPT 5.5 Pro, GPT 5.4, GPT 5.4 Pro, GPT 5.4 Mini, GPT 5.4 Nano, GPT 5.3 Codex, GPT 5.3 Codex Spark, GPT 5.2, GPT 5.2 Codex, GPT 5.1, GPT 5.1 Codex, GPT 5.1 Codex Max, GPT 5.1 Codex Mini, GPT 5, GPT 5 Codex, GPT 5 Nano

Claude models Claude Fable 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6, Claude Opus 4.5, Claude Opus 4.1, Claude Sonnet 4.6, Claude Sonnet 4.5, Claude Sonnet 4, Claude Haiku 4.5, Claude 3.5 Haiku

Gemini models Gemini 3.5 Flash, Gemini 3.1 Pro, Gemini 3 Flash

Other models Qwen 3.6 Plus, Qwen 3.5 Plus, MiniMax M2.7, MiniMax M2.5, GLM 5.1, Kimi K2.6, Kimi K2.5, Grok Build 0.1, Big Pickle, DeepSeek V4 Flash Free, Nemotron 3 Super Free

Requirements

• PHP 7.4 or higher
• WordPress 7.0 or higher
• An OpenCode Zen 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 is fully compatible with any plugin built on the WordPress AI Client SDK.

Supported SupportedOptions: temperature, maxTokens, topP, presencePenalty, frequencyPenalty, stopSequences, systemInstruction, functionDeclarations

Provider ID: opencode-zen

Base URL: https://opencode.ai/zen/v1

API key resolution order: 1. OPENCODE_ZEN_API_KEY environment variable 2. WordPress option connectors_ai_opencode_zen_api_key (Settings > Connectors) 3. WordPress option wp_ai_client_credentials['opencode-zen']['api_key'] (legacy)

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 — 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.