Cloudflare Developers：开发者文档与 AI 应用构建指南

Cloudflare Developers 是 Cloudflare 的官方开发者文档与技术入口，集中提供产品指南、API 参考、示例和入门教程。它适合希望搭建网站、后端接口或 AI 应用的开发者，也帮助技术团队理解计算、模型推理、存储和安全服务如何配合使用。

通俗理解：这个网站到底是干什么用的？

可以把 Cloudflare Developers 理解成一套“云端积木的说明书”。你想上线一个网站、写一个能被其他程序调用的接口，或者给应用加入 AI 问答、文件存储和知识检索能力，这里会告诉你该选哪块积木、需要什么前提，以及如何把它接到自己的代码里。

网站本身提供学习与查阅入口；实际创建资源、运行模型和部署程序，需要进入 Cloudflare 控制台，或使用命令行与 API。阅读文档通常不需要付费，但使用文档介绍的云服务可能产生费用。它更适合愿意动手开发的人，不能把阅读教程等同于已经获得一个完整可用的商业应用。

构建 AI 应用：模型推理、调用管理与智能体各司其职

Workers AI 负责运行模型。开发者按模型要求提交文本、图片或其他输入，获取生成内容、向量等结果。模型运行在 Cloudflare 的基础设施上，可以从 Worker 内调用，也可以让现有后端通过 REST API 接入，无需自行运维 GPU。不同模型的能力、输入格式和使用条件需要分别检查。

AI Gateway 负责观察和管理模型请求，提供分析、日志、缓存、限流、重试与模型回退等能力，并支持多个模型服务商。它适合解决“哪些请求失败了”“调用消耗在哪里”“如何控制访问频率”等实际运营问题。

Agents 面向需要持续状态和工具调用的智能体应用，提供会话状态、实时连接、定时任务及 MCP 等相关能力。模型负责生成或推理，智能体程序负责组织任务和工具；具体业务逻辑、权限与结果验证仍由开发者设计。

给应用配数据层：R2、D1、KV 与 Vectorize 怎么分工？

• R2：保存图片、文档、数据集等对象和文件，提供兼容 S3 的对象存储接口。
• D1：保存用户记录、商品、订单等关系型数据，使用 SQL 查询。
• KV：保存适合键值访问的数据，例如配置；选型时要理解它的一致性与更新限制。
• Durable Objects：处理需要协调和保持状态的应用逻辑，例如实时交互。
• Vectorize：保存与检索向量表示，支持语义搜索、相似内容查找等 AI 工作流。

例如，知识问答应用可以把原文件放在 R2，把业务记录放在 D1，再用 Vectorize 检索相关内容供模型参考。这只是可采用的架构，上传文件不会自动完成切分、权限管理与答案校验。可通过官方存储选型指南进一步判断组合方式。

从第一个 Worker 到一次真正的 AI 请求

初次使用可以先完成Workers 官方入门教程，确认自己能创建、修改和部署一个最小程序：

1. 准备 Cloudflare 账号与受支持的 Node.js 环境，运行 npm create cloudflare@latest -- my-first-worker，选择简单的 Worker 示例。
2. 进入项目目录，运行 npx wrangler dev，打开终端给出的本地地址。
3. 修改源文件返回的文本，保存后刷新页面，确认输出确实改变。
4. 运行 npx wrangler deploy，按提示完成账号授权，访问返回的 workers.dev 地址检查线上结果。

如果目标只是测试模型，也可以直接走Workers AI REST API 入门路径：在控制台取得 Account ID 与对应 API Token，选定模型，发送官方示例中的认证请求，再检查 JSON 返回值、成功标记和错误信息。令牌应由服务端保管，不应放进公开的前端代码。通过本地开发工具发起的 AI 推理仍可能计入服务额度。

网站上线以后：域名、安全与访问性能

这个入口不只介绍 AI。DNS、缓存、TLS、WAF 和 Turnstile 等文档，分别帮助用户处理域名解析、内容分发、连接加密、应用防护与访客验证。Turnstile 可以嵌入网站，不要求整个网站的流量先经过 Cloudflare。

应按实际问题阅读对应产品文档：成功部署一个 Worker，并不等于所有防护、缓存或访问规则已经配置完成。对于已有网站的维护者，这些操作指南与排错资料往往比模型目录更有用。

免费额度与费用：按产品计算，不能只看一个套餐

文档可以公开阅读，实际云资源则按产品与用量计费。截至 2026 年 10 月 7 日，Workers AI 官方定价列出每天 10,000 Neurons 的免费分配，按 UTC 00:00 重置。超出该额度需要 Workers Paid；部分模型还要求付费计费方式，因此不能理解成所有模型都可以无条件免费调用。

AI Gateway 的核心分析、缓存和限流能力免费，但模型推理、日志与其他功能可能另外收费。网关计费说明还根据首次创建网关的时间区分日志计费规则。官方美元价格不代表人民币含税总成本，也不存在覆盖 Workers、存储、数据库和全部模型调用的统一免费承诺。

接入真实数据之前，先看日志与模型许可

Workers AI 数据使用说明表示，未经明确同意，不会将客户内容用于训练模型或改进服务；但如果同时使用 R2、KV 等存储产品，内容可能被保存。这项说明不能直接套用到所有外部模型供应商。

AI Gateway 日志默认开启，可能包含提示词与模型响应，接入业务数据前应检查日志收集和内容保存设置。商用时也要查看具体模型的许可条件，不能因为获得 API 访问权限，就推断所有模型与输出都没有使用限制。

常见问题

Cloudflare Workers AI 免费额度够不够用？

取决于模型、输入输出规模和调用频率。每日免费分配不等于固定次数，也不等于无限使用；还需要同时考虑模型要求与任务级限流。建议先用代表性请求观察控制台用量。

不部署 Worker，也能调用 AI 模型吗？

可以。已有服务端可以通过 REST API 调用，准备 Account ID、合适权限的令牌和符合模型要求的请求体即可，不必为了测试接口先迁移整套应用。

AI Gateway 免费，是否意味着模型调用也免费？

不是。网关核心管理能力与模型推理是不同的计费环节，还可能涉及日志等费用。应分别核对模型提供方、计费方式与网关设置。

官方资源与开发者社区

• Cloudflare API 参考：查询接口、认证和参数。
• 开发者 Discord：交流接入问题与项目实践。
• Cloudflare GitHub：查看官方项目与源代码仓库。
• CloudflareDev 官方动态：跟进开发者产品公告。
• 官方支持与服务状态页：查询帮助资料与故障信息。