Cloudflare Workers AI

先分清托管平台与模型作者

Cloudflare Workers AI 在 Cloudflare 网络上运行多家作者的模型。Cloudflare 是托管和计费平台，不应把 Meta、BAAI、Mistral、BFL 等目录模型写成 Cloudflare 自研。完整 ID 通常采用 @cf/<author>/<model>；许可证、模态、参数和生命周期都以该目录条目为准。

原生路径与 OpenAI 兼容路径不同

直连原生 REST 使用账户路径 /client/v4/accounts/{account_id}/ai/run/@cf/<author>/<model>，模型 ID 位于 URL；OpenAI 兼容 Base URL 是 /client/v4/accounts/{account_id}/ai/v1，再调用 Chat Completions、Responses 或 Embeddings，并把完整模型 ID 放入 JSON。本站列出的 /v1/* 是本站 Base URL 下的适配入口，使用本站 Bearer 令牌，不包含 Cloudflare Account ID。

兼容不等于全目录统一

原生任务可以覆盖文本、Embedding、图像、语音等多类 schema；OpenAI 兼容只覆盖官方明确列出的资源和模型。即使路径相同，不同模型的工具、视觉、流式、上下文和错误也可能不同。上线前用精确 @cf/... ID 做字段级契约测试，并监控弃用公告。

Batch 是独立异步能力

Workers AI Batch 把一组请求排队处理，创建时返回 queued 与 request_id，稍后再查询结果，适合离线摘要或 Embedding。总 payload 必须低于官方限制，且仅目录标记支持 Batch 的模型可用。本站当前 api_paths 未列 Batch，因此不能把 Cloudflare 原生 Batch 路径当作本站入口。

Neurons、429 与成本

Cloudflare 后台使用 Neurons 表示跨模型 GPU 计算，目录会把 token、图像或其他单位换算为 Neurons；免费分配与付费单价会调整，应以当前 Pricing 为准。429 既可能是每日免费分配耗尽，也可能是容量不足，读取 Cloudflare error code 后再升级、降速或有限退避。为每个模型设置并发、日预算和用量告警，API Token 只授予必要的 Workers AI Read/Edit 权限。