Skip to content

Use WordPress AI with the Gateway

The AI Provider for amazee.ai plugin connects the WordPress AI features to the Gateway. Once installed, AI-powered features on your site run through your regional endpoint, keeping your data in the region you choose.

Models are discovered dynamically from your endpoint, so new models become available on your site without a plugin update.

Prerequisites

  • WordPress 7.0+
  • An account on the application portal — create one at my.amazee.io
  • The official AI plugin from WordPress.org, which supplies the AI features that use this connection

Install

From within WordPress

  1. Go to Plugins → Add New
  2. Search for AI Provider for amazee.ai, then click Install Now and Activate

With Composer

For sites managed with Composer:

composer require wpackagist-plugin/ai-provider-for-amazee-ai

Released versions bundle their own autoloader — no build step needed.

Configure

  1. Log into my.amazee.io to obtain your endpoint URL and API key
  2. Go to Settings → amazee.ai (/wp-admin/options-general.php?page=ai-provider-for-amazee-ai) and enter your endpoint URL, e.g. https://llm.us103.amazee.ai. There is no default endpoint — your API key only works with the region it was issued for, so copy the exact URL from my.amazee.io.
  3. Go to Settings → Connectors (/wp-admin/options-connectors.php), find the amazee.ai connector and enter your API key. The Settings → amazee.ai screen then shows the connection status and the models available to your account.
  4. Install and activate the AI plugin. Go to Settings → AI and turn on the features you want.

Option: configure via wp-config.php

For automated or CI/CD-managed sites, skip the UI entirely by defining constants:

define( 'AMAZEE_ENDPOINT_URL', 'https://llm.us103.amazee.ai' );
define( 'AMAZEE_LLM_TOKEN', 'sk-...' );

The AMAZEEIO_API_KEY environment variable is also supported for the key. These names are set by the plugin, so use them exactly as shown.

What you can do

Feature What it does
Chat completions Conversational AI, content generation, and chat-based interactions
Image vision Send images to supported multimodal models
Tool / function calling Let models call tools, with JSON output formatting
Streaming responses Stream tokens as they're generated
Image generation Generate images in regions whose endpoint offers an image model — detected automatically, no configuration needed

Other modes (embeddings, audio) are not exposed yet.

Data residency

Your data is processed in the region you select at my.amazee.io. Available regions:

Region Endpoint
🇪🇺 Europe llm.de-eu101.amazee.ai
🇬🇧 United Kingdom llm.uk103.amazee.ai
🇨🇭 Switzerland llm.ch103.amazee.ai
🇺🇸 United States llm.us103.amazee.ai
🇦🇺 Australia llm.au103.amazee.ai

In the plugin settings, enter the endpoint with https:// in front and no /v1, e.g. https://llm.ch103.amazee.ai.

Need a different region? Contact ai.support@amazee.io.

Troubleshooting

API key not accepted
Confirm the endpoint URL under Settings → amazee.ai matches the region your key was issued for — a key for one region won't work against another region's endpoint.
No models appear
The model list is cached for 12 hours. After changing the endpoint or key, revisit Settings → amazee.ai to refresh the connection check, and confirm both endpoint and key are saved.
AI features don't show up on the site
The provider plugin only supplies the connection. Install the AI plugin, then turn features on under Settings → AI.
A plugin says it isn't allowed to use the connector
If the AI plugin's Connector Approvals experiment is on, an admin has to approve each plugin before it can use the amazee.ai connector.

Resources