别再报错了！轻松搞定 Cloudflare 兼容 OpenAI 的 Base URL 与接口配置

Cloudflare AI 基础 URL 总是报错 404？

本文秒级教会你如何快速获取并配置 Cloudflare 兼容 OpenAI 的 Base URL。内含官方 REST API、AI Gateway 格式及第三方客户端（Dify/One-API）完美对接模板，助你一键跑通免费 AI 接口！

上周一个做独立开发的朋友突然找我， 发来一张截图， 满屏幕的 401。他说哥我调 Cloudflare 的 AI 接口调了一天了， 就是跑不通。

我看了眼他的代码， Base URL 写的是 /ai/v1 那条， 但请求体塞的是官方 REST API 的格式， 两边根本不搭。

他说我就想用 OpenAI 的 SDK 调一下 Workers AI 上面的模型， 有什么问题吗。

问题大了。

Cloudflare 的 AI 服务， 根据不同场景， 有三套完全不一样的 Base URL。每一套都有自己的格式和适用场景， 文档虽然也写了， 但散落在不同的页面里， 你第一次搞根本不知道看哪个。走错了就是 401 或者 400， 根本不给你跑。

我自己最早踩这个坑的时候， 也是来回试了好几遍才搞清楚， 当时对着满屏报错真的一阵无语。。。

今天就把这三条路给你画清楚， 看完不会再报错那种。

OpenAI 兼容接口 Base URL

先说最常用的那条。

如果你用的是 OpenAI SDK， 或者 LangChain、Dify、NextChat、One-API 这些支持自定义 OpenAI 格式的工具， 走这条路就行

https://api.cloudflare.com/client/v4/accounts/{你的account_id}/ai/v1

这是 Cloudflare 专门为了对标 OpenAI 接口格式搞的。完整对话 endpoint 后面加 /chat/completions。你原来填 OpenAI Base URL 的地方换成这个， API Key 换成 Cloudflare 的 Token， 就能直接跑起来。我试过 @cf/deepseek-ai/deepseek-r1-distill-qwen-32b、@cf/meta/llama-3.1-8b-instruct 这些模型， 都没问题。

但要注意， 这条只支持文本对话类的模型。

Cloudflare 官方原生 REST API

你要调 Stable Diffusion 画图、Whisper 转录音频， 或者任何非文本类的模型， 就走第二条路， 也就是 Cloudflare 官方原生 REST API

https://api.cloudflare.com/client/v4/accounts/{你的account_id}/ai/run

模型名能写在路径上， 比如 /ai/run/@cf/bytedance/stable-diffusion-xl-lightning， 也能放在请求体的 model 字段里。我习惯放字段里， 路径短一点， 看着清爽。这个细节我一开始也搞混过， 有的模型两种都行， 有的只认一种， 查文档的时候多留个心眼。

AI Gateway 的 Base URL

还有第三条路， AI Gateway。

这个场景不太一样。你如果在 Cloudflare 后台建了 AI Gateway， 用来代理第三方 API， 比如把 OpenAI 的请求走 Cloudflare 网关转发， 方便做缓存、监控、限流， 那 Base URL 就是

https://gateway.ai.cloudflare.com/v1/{你的account_id}/{你的gateway_id}/openai

完整 endpoint 后面加 /chat/completions， 所有流量走 Cloudflare 网关， 日志面板里能看到每一次请求的延迟和结果。团队项目多了之后， 这个功能真挺有用的， 不用一个一个去各个厂商的后台翻数据。

如何选择：三套 URL 一句话说清楚

好， 三条路说完了。总结起来就一条原则

你用什么工具， 就走什么路。

用 OpenAI SDK 调对话模型， 走 /ai/v1。调图片音频模型， 走 /ai/run。想走网关统一管理， 走 /gateway/。认证方式都一样， Header 里放 Authorization: Bearer 你的 API Token， Token 去 Cloudflare 后台创建， 记得勾 Workers AI: Edit 权限。

account_id 在哪找。登录 Cloudflare 后台， 右侧边栏往下翻到 API 区域， 或者看浏览器地址栏， 那串 32 位的字母数字就是。

说真的， 那天帮朋友搞定之后， 他跟我说了一句话， 我觉得挺对的 原来不是我不会， 是文档没给我讲清楚。

很多技术配置都是这样。不是多难， 是入口太多， 第一次走很容易迷路。你如果在配置 Cloudflare AI 的时候也碰到过各种莫名报错， 大概率就是 Base URL 选错或者格式没对上。这三套 URL 收藏好， 下次直接对号入座就行。

不用谢。

以上， 既然看到这里了， 如果觉得不错， 随手点赞、转发吧， 如果想第一时间收到推送， 也可以给我个关注⭐～

谢谢你看我的文章， 我们， 下次再见。