Cloudflare Workers AI 使用教程：调用与工具集成实践

Cloudflare Workers AI 是 Cloudflare 推出的无服务器边缘 AI 推理平台。它允许开发者通过简单的 API 调用，在全球 300+ 个 Cloudflare 边缘节点上运行主流开源 AI 模型，无需管理任何 GPU 基础设施。

简单来说：你不需要买显卡、不需要部署模型、不需要考虑扩容——只需要一个 API 密钥，就能在你的应用里集成大语言模型、图像识别、代码生成等 AI 能力。

可以通过 Experiment with models 体验

计费单位：神经元（Neuron）：Cloudflare Workers AI 不按传统的“请求次数”或“GPU 时长”计费，而是引入了一个抽象的计算单位——神经元（Neuron）。
基本公式：$Neurons = (输入 Token 数 × 输入系数) + (输出 Token 数 × 输出系数)$

每日免费：10,000 Neurons（每天自动重置）,超出部分根据具体的模型和使用场景计费，可以参考Pricing · Cloudflare Workers AI docs

支持的任务类型：文本生成（Text Generation）、文本嵌入（Text Embeddings）、文本分类（Text Classification）、文本转图像（Text-to-lmage）、文本转语音（Text-to-Speech）、自动语义识别（Automatic Speech Recognition）、图像转文本（Image-to-Text）、图像分类（Image Classification）、翻译（Translation）等。

如何通过 API 调用 Workers AI

要调用 Workers AI，你需要两个关键信息：Account ID 和 API Token。
在开始一切之前，请确保有一个Cloudflare账号。

REST API 获取

1. 登录你的账号，进入 Workers AI页面（https://dash.cloudflare.com/{你的账号}/ai/workers-ai/usage）
2. 点击 REST API按钮，创建Workers AI API令牌，在弹出的右侧侧栏中点击创建API令牌。
3. 将你的帐户 ID和API令牌复制（API Token 仅显示一次，关闭页面后无法再次查看
   ）。

在本地工具中调用

Workers AI 提供了 OpenAI 兼容的 API 端点,不支持其他协议，具体调用格式和参数如下：

• API 地址： https://api.cloudflare.com/client/v4/accounts/{您的账户ID}/ai/v1
• API 密钥：您的API令牌
• 模型名称格式：@cf/组织名/模型名，具体可用模型可以在 Cloudflare Workers AI 模型文档

常用模型表：

• @cf/google/gemma-4-26b-a4b-it
• @cf/ibm-granite/granite-4.0-h-micro
• @cf/meta/llama-4-scout-17b-16e-instruct
• @cf/meta/llama-4-scout-17b-16e-instruct
• @cf/meta/llama-3.1-8b-instruct-awq
• @cf/meta/llama-3.2-3b-instruct
• @cf/mistral/mistral-7b-instruct-v0.1
• @cf/openai/gpt-oss-120b
• @cf/openai/gpt-oss-20b
• @cf/qwen/qwen3-30b-a3b-fp8
• @cf/zai-org/glm-4.7-flash

写在最后

AI 技术正在以前所未有的速度改变软件开发的方式。而 Cloudflare Workers AI 的出现，让每一位开发者——无论你是独立开发者、学生，还是企业工程师——都能以极低的成本在自己的应用中融入 AI 能力。

希望这篇教程能帮你顺利迈出第一步，为你的开发与代码实践助力。

相关参考与推荐项目：

1. Experiment with models
2. Overview · Cloudflare Workers AI docs
3. Pricing · Cloudflare Workers AI docs
4. Cloudflare Workers AI 模型文档
5. Workers AI模板广场
6. Cloudflare 免费模型食用指南 - 资源荟萃 - LINUX DO
7. ✨ 基于 Cloudflare AI & Workers 的免费在线文生图服务