
One API 的 OpenAI 渠道如何接入 Cloudflare AI Gateway【免费下载链接】one-apiLLM API 管理 分发系统支持 OpenAI、Azure、Anthropic Claude、Google Gemini、DeepSeek、字节豆包、ChatGLM、文心一言、讯飞星火、通义千问、360 智脑、腾讯混元等主流模型统一 API 适配可用于 key 管理与二次分发。单可执行文件提供 Docker 镜像一键部署开箱即用。LLM API management key redistribution system, unifying multiple providers under a single API. Single binary, Docker-ready, with an English UI.项目地址: https://gitcode.com/GitHub_Trending/on/one-api如果你希望 One API 的 OpenAI 渠道把请求经由 Cloudflare AI Gateway 转发到上游而不是直连 OpenAI官方给出的接入方式非常直接不需要改代码在渠道设置的代理部分填入 gateway 地址即可。本文基于仓库 README 的功能说明与 OpenAI 适配器的源码给出从渠道配置到验证的完整操作路径。适用前提一个已部署运行的 One API 实例渠道类型为 OpenAI。这条路径不适用于 Cloudflare Workers AI 等其他渠道类型。准备条件One API 实例正在运行。如果还没有部署可以使用 README.md 中的 Docker 部署命令SQLite 版docker run --name one-api -d --restart always -p 3000:3000 -e TZAsia/Shanghai -v /home/ubuntu/data/one-api:/data justsong/one-api其中-p 3000:3000的第一个3000是宿主机端口可按需修改-v挂载的目录需存在且具有写入权限也可以改成其他合适目录。并发量较大时务必追加SQL_DSN环境变量改用 MySQL例如-e SQL_DSNroot:123456tcp(localhost:3306)/oneapi。使用初始账号登录系统用户名root密码123456。README 明确要求使用 root 用户初次登录后务必修改默认密码。准备好会出现在 gateway 地址里的两个值你的 Cloudflare 账号标识和要使用的 AI Gateway 名称。README 给出的接入格式如下其中ACCOUNT_TAG和GATEWAY是需要替换的占位符https://gateway.ai.cloudflare.com/v1/ACCOUNT_TAG/GATEWAY/openai这两个占位符对应什么可以从仓库源码注释中确认relay/adaptor/cloudflare/adaptor.go 中的注释展示了同一 gateway 域名的路径参数位置为{account_id}和{gateway_id}即分别替换为你自己的账号 ID 与 gateway ID。在 OpenAI 渠道中填写 Gateway 地址在渠道页面添加渠道选择 OpenAI 渠道类型并填写上游 API Key。README 功能列表对这条接入路径的原文说明是支持 Cloudflare AI Gateway渠道设置的代理部分填写https://gateway.ai.cloudflare.com/v1/ACCOUNT_TAG/GATEWAY/openai即可。也就是说渠道类型保持 OpenAI 不变把 gateway 地址替换为你自己的账号标识和 gateway 名称填入该渠道的代理字段https://gateway.ai.cloudflare.com/v1/你的账号标识/你的 gateway 名称/openai结尾的openai段与 README 模板保持一致它决定 One API 实际拼接出的请求路径。这个拼接规则在 relay/adaptor/openai/helper.go 中当渠道 BaseURL 以https://gateway.ai.cloudflare.com开头时OpenAI 渠道会把请求路径中的/v1前缀去掉后再拼到 BaseURL 后面Azure 渠道则去掉/openai/deployments前缀。因此 chat completions 请求最终会发往.../GATEWAY/openai/chat/completions即 gateway 提供的 OpenAI 兼容端点。验证接入按 README.md 的使用方式验证分两步渠道测试在渠道页面为该渠道选择测试模型test_model后点击测试按钮前端调用的是/api/channel/test/{id}?model{model}接口见 web/default/src/components/ChannelsTable.js。测试通过说明 One API 经 gateway 到上游的链路可达。令牌请求验证在令牌页面新增访问令牌然后用令牌以与 OpenAI API 一致的方式访问 One API——把 API Base 设置为你的部署地址格式取决于客户端例如 OpenAI 官方库使用https://HOST:PORT/v1的形式API Key 填令牌值OPENAI_API_KEYsk-xxxxxx OPENAI_API_BASEhttps://HOST:PORT/v1其中HOST:PORT替换为你实例的部署地址。如果该渠道与其他 OpenAI 渠道共存、希望确认请求确实走了这条 gateway 渠道可以在令牌后附加渠道 ID 指定渠道处理本次请求例如Authorization: Bearer ONE_API_KEY-CHANNEL_ID注意需要管理员用户创建的令牌才能指定渠道 ID不指定则走多渠道路由。已知报错与边界README 常见问题中列出的渠道测试报错invalid character looking for beginning of value原因是返回值不是合法 JSON 而是一个 HTML 页面大概率是部署站的 IP 或代理节点被 CloudFlare 封禁。如果接入 gateway 后渠道测试报这个错误应优先检查服务器出口 IP 是否被 Cloudflare 拦截。本文路径针对OpenAI 渠道经 gateway 访问 OpenAI 提供商。Cloudflare Workers AI 在 One API 中是独立的渠道类型其 gateway 地址以/workers-ai结尾见 relay/adaptor/cloudflare/adaptor.go 注释配置路径不同不在本文范围内。渠道测试通过、令牌请求能返回正常模型响应即表示接入完成该 OpenAI 渠道的后续请求都会经你指定的 Cloudflare AI Gateway 转发。【免费下载链接】one-apiLLM API 管理 分发系统支持 OpenAI、Azure、Anthropic Claude、Google Gemini、DeepSeek、字节豆包、ChatGLM、文心一言、讯飞星火、通义千问、360 智脑、腾讯混元等主流模型统一 API 适配可用于 key 管理与二次分发。单可执行文件提供 Docker 镜像一键部署开箱即用。LLM API management key redistribution system, unifying multiple providers under a single API. Single binary, Docker-ready, with an English UI.项目地址: https://gitcode.com/GitHub_Trending/on/one-api创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考