AIPCF – AI Provider for Cloudflare

This plugin connects WordPress to Cloudflare Workers AI, making its hosted large language models available to any WordPress feature or plugin that uses the WordPress AI Client (introduced in WordPress 7.0).

Supported models

The plugin fetches the full list of available text generation models directly from your Cloudflare account and shows them in the settings dropdown, so you always see what is actually available to you. The list is cached for 12 hours and refreshed whenever you save your credentials.

A built-in fallback list is used when your credentials are not yet configured or the API is unreachable. See Cloudflare’s model catalogue for the current full list.

Why Cloudflare Workers AI?

Unlike hosted AI services that charge per seat or per API call at a premium rate, Cloudflare Workers AI runs inference at the edge on a usage-based model. The free tier covers 10,000 neurons per day (Cloudflare’s billing unit — roughly 200–500 average generation requests) — enough for a content-heavy site to generate post summaries, meta descriptions, and moderation checks without any cost. Paid usage is billed per neuron, making it significantly cheaper at scale compared to per-token pricing from closed providers.

Your prompts and completions also never leave Cloudflare’s network to reach a third-party AI company’s servers, which matters for sites with privacy or data-residency requirements.

What you need

1. A Cloudflare account with Workers AI enabled.
2. Your Account ID — visible on the Workers AI dashboard sidebar.
3. A Cloudflare API token with the “Workers AI – Edit” permission.

Usage

Once the plugin is configured, any WordPress AI Client-compatible feature or plugin will automatically use Cloudflare Workers AI as its provider.

Developers can also call it directly:

use WordPress\AiClient\AiClient;

$result = AiClient::prompt( 'Summarise this post in two sentences.' )
    ->usingProvider( 'cloudflare-workers-ai' )
    ->usingModel( '@cf/meta/llama-4-scout-17b-16e-instruct' )
    ->generateTextResult();

echo $result->toText();

Switch models without changing any other code — swap llama-4-scout-17b-16e-instruct for qwen2.5-coder-32b-instruct and you are running a coding assistant instead.

This plugin does not add a chatbot or front-end widget by itself. It registers the provider so that other AI Client-powered features, plugins, and themes can use it.

External Services

This plugin connects to the Cloudflare Workers AI REST API to run AI inference.

The service is used to:

• Run text generation requests against the model you select.
• Verify your Account ID and API token when you click “Test connection”.

What data is sent and when

When you click “Test connection” in the plugin settings, your Account ID and API token are sent to https://api.cloudflare.com/client/v4/accounts/{account_id}/ai/models/search to verify the credentials. No prompt data is sent during this check.

When a compatible AI Client feature generates text, the plugin sends your API token, the selected model ID, and the prompt messages to https://api.cloudflare.com/client/v4/accounts/{account_id}/ai/run/{model_id}. Requests are only made when AI generation is explicitly triggered — nothing is sent automatically in the background.

Service provider

Cloudflare Workers AI is provided by Cloudflare, Inc.

• Cloudflare Workers AI documentation: https://developers.cloudflare.com/workers-ai/
• Cloudflare Terms of Service: https://www.cloudflare.com/terms/
• Cloudflare Privacy Policy: https://www.cloudflare.com/privacypolicy/

Roadmap

Current version supports Workers AI edge inference. AI Gateway support for caching, rate-limiting, and analytics coming soon.

1. Upload the plugin folder to /wp-content/plugins/.
2. Activate the plugin through the Plugins menu in WordPress.
3. Go to Settings → Cloudflare Workers AI.
4. Enter your Cloudflare Account ID and API token.
5. Click Save Changes, then Test connection to verify.
6. Use the Text generation model dropdown to choose your preferred model. The full list is fetched live from your Cloudflare account and cached for 12 hours.

wp-config.php constants (optional)

You can define credentials in wp-config.php instead of the settings page:

define( 'CLOUDFLARE_WORKERS_AI_ACCOUNT_ID', 'your-account-id' );
define( 'CLOUDFLARE_WORKERS_AI_API_TOKEN',  'your-api-token' );

You can also hard-code the default model (the settings page dropdown takes precedence over this constant):

define( 'CLOUDFLARE_WORKERS_AI_DEFAULT_MODEL', '@cf/meta/llama-3.3-70b-instruct-fp8-fast' );

Environment variables with the same names are also supported.