Cloudflare Workers AI

Accédez à 22 modèles Cloudflare Workers AI via le routeur de modèles de Mastra. L’authentification est gérée automatiquement à l’aide de la variable d’environnement CLOUDFLARE_API_KEY. Configurez également CLOUDFLARE_ACCOUNT_ID.

Pour en savoir plus, consultez la documentation Cloudflare Workers AI.

.env

CLOUDFLARE_ACCOUNT_ID=your-account-id
CLOUDFLARE_API_KEY=your-api-key

src/mastra/agents/my-agent.ts

import { Agent } from "@mastra/core/agent";

const agent = new Agent({
  id: "my-agent",
  name: "My Agent",
  instructions: "You are a helpful assistant",
  model: "cloudflare-workers-ai/@cf/aisingapore/gemma-sea-lion-v4-27b-it"
});

// Generate a response
const response = await agent.generate("Hello!");

// Stream a response
const stream = await agent.stream("Tell me a story");
for await (const chunk of stream) {
  console.log(chunk);
}

info

Mastra utilise le point de terminaison /chat/completions compatible avec OpenAI. Certaines fonctionnalités propres au Provider peuvent ne pas être disponibles. Consultez la documentation Cloudflare Workers AI pour plus de détails.

Modèles

22 available models

Model	Context	Tools	Reasoning	Image	Audio	Video	Input $/1M	Output $/1M
cloudflare-workers-ai/@cf/aisingapore/gemma-sea-lion-v4-27b-it	128K						$0.35	$0.56
cloudflare-workers-ai/@cf/deepseek-ai/deepseek-r1-distill-qwen-32b	80K						$0.50	$5
cloudflare-workers-ai/@cf/google/gemma-4-26b-a4b-it	256K						$0.10	$0.30
cloudflare-workers-ai/@cf/ibm-granite/granite-4.0-h-micro	131K						$0.02	$0.11
cloudflare-workers-ai/@cf/meta/llama-3.1-8b-instruct-fp8	32K						$0.15	$0.29
cloudflare-workers-ai/@cf/meta/llama-3.2-11b-vision-instruct	128K						$0.05	$0.68
cloudflare-workers-ai/@cf/meta/llama-3.2-1b-instruct	60K						$0.03	$0.20
cloudflare-workers-ai/@cf/meta/llama-3.2-3b-instruct	80K						$0.05	$0.34
cloudflare-workers-ai/@cf/meta/llama-3.3-70b-instruct-fp8-fast	24K						$0.29	$2
cloudflare-workers-ai/@cf/meta/llama-4-scout-17b-16e-instruct	131K						$0.27	$0.85
cloudflare-workers-ai/@cf/meta/llama-guard-3-8b	131K						$0.48	$0.03
cloudflare-workers-ai/@cf/mistralai/mistral-small-3.1-24b-instruct	128K						$0.35	$0.56
cloudflare-workers-ai/@cf/moonshotai/kimi-k2.6	262K						$0.95	$4
cloudflare-workers-ai/@cf/moonshotai/kimi-k2.7-code	262K						$0.95	$4
cloudflare-workers-ai/@cf/nvidia/nemotron-3-120b-a12b	256K						$0.50	$2
cloudflare-workers-ai/@cf/openai/gpt-oss-120b	128K						$0.35	$0.75
cloudflare-workers-ai/@cf/openai/gpt-oss-20b	128K						$0.20	$0.30
cloudflare-workers-ai/@cf/qwen/qwen2.5-coder-32b-instruct	33K						$0.66	$1
cloudflare-workers-ai/@cf/qwen/qwen3-30b-a3b-fp8	33K						$0.05	$0.34
cloudflare-workers-ai/@cf/qwen/qwq-32b	24K						$0.66	$1
cloudflare-workers-ai/@cf/zai-org/glm-4.7-flash	131K						$0.06	$0.40
cloudflare-workers-ai/@cf/zai-org/glm-5.2	262K						$1	$4

Configuration avancée

En-têtes personnalisés

src/mastra/agents/my-agent.ts

const agent = new Agent({
  id: "custom-agent",
  name: "custom-agent",
  model: {
    url: "https://api.cloudflare.com/client/v4/accounts/${CLOUDFLARE_ACCOUNT_ID}/ai/v1",
    id: "cloudflare-workers-ai/@cf/aisingapore/gemma-sea-lion-v4-27b-it",
    apiKey: process.env.CLOUDFLARE_API_KEY,
    headers: {
      "X-Custom-Header": "value"
    }
  }
});

Sélection dynamique du modèle

src/mastra/agents/my-agent.ts

const agent = new Agent({
  id: "dynamic-agent",
  name: "Dynamic Agent",
  model: ({ requestContext }) => {
    const useAdvanced = requestContext.task === "complex";
    return useAdvanced
      ? "cloudflare-workers-ai/@cf/zai-org/glm-5.2"
      : "cloudflare-workers-ai/@cf/aisingapore/gemma-sea-lion-v4-27b-it";
  }
});