Skip to main content
Enabled when both CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID are set in your environment.

​
Overview

The @standardagents/cloudflare package provides a Cloudflare Workers AI provider factory for Standard Agents. It targets Cloudflare’s OpenAI-compatible Chat Completions endpoint and adds typed providerOptions, model discovery via Cloudflare’s models API, and request inspection support in the admin UI.

Key Features

  • Direct integration with Cloudflare’s account-scoped /ai/v1/chat/completions endpoint
  • Typed providerOptions for Workers AI request parameters
  • Remote model discovery with search and pagination for @cf/... chat models in the builder UI
  • Tool calling, structured outputs, streaming, and multimodal model support where documented

​
Installation

npm
npm install @standardagents/cloudflare
pnpm
pnpm add @standardagents/cloudflare
yarn
yarn add @standardagents/cloudflare

​
Quick Start

agents/models/workers_fast.ts
import { defineModel } from '@standardagents/spec';
import { cloudflare } from '@standardagents/cloudflare';

export default defineModel({
  name: 'workers-fast',
  provider: cloudflare,
  model: '@cf/meta/llama-3.1-8b-instruct',
  inputPrice: 0.1,
  outputPrice: 0.1,
});

​
Provider Factory

import { cloudflare } from '@standardagents/cloudflare';

defineModel({
  name: 'workers-reasoning',
  provider: cloudflare,
  model: '@cf/openai/gpt-oss-120b',
});

​
Provider Options

import { defineModel } from '@standardagents/spec';
import { cloudflare } from '@standardagents/cloudflare';

export default defineModel({
  name: 'workers-reasoning',
  provider: cloudflare,
  model: '@cf/openai/gpt-oss-120b',
  providerOptions: {
    seed: 42,
    user: 'user-123',
    logprobs: true,
    top_logprobs: 5,
  },
});

​
Available Options

OptionTypeDescription
baseUrlstringOverride the default OpenAI-compatible base URL
seednumberBest-effort deterministic sampling seed
userstringEnd-user identifier
logprobsbooleanReturn token log probabilities
top_logprobsnumberNumber of top logprobs to return
frequency_penaltynumberFrequency penalty forwarded to the chat endpoint
presence_penaltynumberPresence penalty forwarded to the chat endpoint
By default, the provider builds the base URL from CLOUDFLARE_ACCOUNT_ID. Set providerOptions.baseUrl if you want to route through a different OpenAI-compatible endpoint such as AI Gateway.

​
Model IDs

Workers AI model IDs are sent directly, for example:
  • @cf/meta/llama-3.1-8b-instruct
  • @cf/meta/llama-4-scout-17b-16e-instruct
  • @cf/openai/gpt-oss-120b
  • @cf/qwen/qwen3-30b-a3b-fp8
  • @cf/zhipu-ai/glm-4.7-flash
The builder fetches available models from Cloudflare’s account-scoped models API, so the model picker can search and paginate through the live Workers AI catalog. The provider keeps a small static fallback catalog for capability hints and as a fallback if the models API is unavailable.

​
Capabilities

The provider exposes model capabilities for the bundled Workers AI fallback catalog, including:
  • supportsImages for multimodal models like Llama 3.2 Vision and Llama 4 Scout
  • supportsToolCalls for models Cloudflare documents with function calling
  • supportsJsonMode and supportsStreaming for the OpenAI-compatible chat API
  • reasoningLevels for reasoning-focused models like @cf/openai/gpt-oss-120b

​
Environment Setup

.dev.vars
CLOUDFLARE_API_TOKEN=...
CLOUDFLARE_ACCOUNT_ID=...
For Cloudflare Workers: 
wrangler secret put CLOUDFLARE_API_TOKEN
CLOUDFLARE_ACCOUNT_ID should be set as an environment variable in your worker configuration.

​
Notes

  • The provider uses Cloudflare’s OpenAI-compatible /chat/completions API.
  • Authentication uses a Cloudflare API token, not a traditional provider-specific API key.
  • The current package focuses on text-generation/chat-completions models, not embeddings or image generation.

Models

Core model concepts

Cerebras Provider

Compare with Cerebras

OpenRouter Provider

Compare with OpenRouter