新闻详情

新闻详情

首页 / 资讯中心 / 详情

Metapi 客户端接入指南:Cursor、Claude Code、Open WebUI 一键接入全模型,附配置避坑清单

发布时间:2026/9/27 1:53:02来源:尧图网络
Metapi 客户端接入指南:Cursor、Claude Code、Open WebUI 一键接入全模型,附配置避坑清单
Metapi 客户端接入指南Cursor、Claude Code、Open WebUI 一键接入全模型附配置避坑清单【免费下载链接】metapi把你在各处注册的 New API / One API / OneHub / DoneHub / Veloera / AnyRouter / Sub2API 等站点 汇聚成 一个 API Key、一个入口自动发现模型、智能路由、成本最优项目地址: https://gitcode.com/gh_mirrors/meta/metapiMetapi 是一个把 New API、One API、DoneHub、Veloera、AnyRouter、Sub2API 等分散中转站汇聚成一个 API Key、一个入口的 AI 模型聚合网关支持自动发现模型、智能路由与故障转移。这篇 Metapi 客户端接入指南教你用最少配置把 Cursor、Claude Code、Open WebUI 等 AI 客户端一键接入全部模型文末还附了一份实战避坑清单。接入前只需知道两件事Metapi 对外暴露标准的 OpenAI / Claude 兼容接口因此绝大多数客户端接入时只需要配置两项配置项填什么Base URL客户端会自动补/v1的字段填https://your-domain.com要求完整 API 地址的字段填https://your-domain.com/v1API Key部署时设置的PROXY_TOKEN或在后台创建的下游 API Key模型列表由客户端自动从GET /v1/models拉取无需手动填写模型。支持的接口包括/v1/chat/completions、/v1/messagesClaude、/v1/responses、/v1/embeddings、/v1/files等完整清单见客户端接入文档。 不确定客户端是否自动补/v1先填根域名报 404 再改成带/v1的完整路径。Cursor 接入步骤30 秒配好 OpenAI Base URLCursor 走标准 OpenAI 格式接入只需两步打开Settings → Models在OpenAI API Key填入你的PROXY_TOKEN并在Override OpenAI Base URL填入https://your-domain.com/v1保存后即可在模型列表中选择 Metapi 聚合的全部模型流式补全、多轮对话均可直接使用。具体字段对照见 docs/client-integration.md。Claude Code 接入ANTHROPIC_BASE_URL 一次配好Claude Code 使用 Anthropic 格式Metapi 会自动完成格式转换你只需编辑~/.claude/settings.json{ env: { ANTHROPIC_BASE_URL: https://your-domain.com, ANTHROPIC_API_KEY: your-proxy-sk-token, ANTHROPIC_AUTH_TOKEN: your-proxy-sk-token, CLAUDE_CODE_ATTRIBUTION_HEADER: 0, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: 1 } }变量作用ANTHROPIC_BASE_URL填根域名即可Claude Code 会自动拼接/v1/messagesANTHROPIC_API_KEY/ANTHROPIC_AUTH_TOKEN填PROXY_TOKEN不同版本读取的变量不同建议两个都设CLAUDE_CODE_ATTRIBUTION_HEADER设为0避免部分上游不支持该头导致报错CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC设为1关闭遥测等非必要请求变量详细说明见 docs/client-integration.md。Open WebUI 接入OpenAI API URL 直接指向 Metapi进入Settings → Connections → OpenAI API URL填入https://your-domain.com/v1该字段要求完整路径注意带/v1API Key填入PROXY_TOKENOpen WebUI 会自动拉取全部模型支持对话与文件上传Metapi 已支持标准/v1/files文件链路PDF、Markdown、图片附件可经 Metapi 转发。其他客户端一张表搞定客户端填法Cherry Studio模型提供商 → OpenAI → API 地址填https://your-domain.com/v1 API KeyCodex CLIconfig.toml中base_url https://your-domain.com/v1auth.json填OPENAI_API_KEYRoo Code / Kilo Code同 Cursor/v1地址 API Key任何 OpenAI 兼容客户端找到 Base URL 与 API Key 两个配置位即可Codex CLI 的完整配置示例见 docs/client-integration.md。下游 API Key给每个项目发一把专属钥匙多人或多项目共用一个 Metapi 实例时不必把全局PROXY_TOKEN到处分发。在管理后台下游密钥页面可为每个项目创建独立 Key分别设置过期时间、费用/请求上限、模型白名单支持通配符与正则、路由白名单和站点倍率字段说明详见配置文档。接入自检3 步验证模型与对话链路配置完成后建议在 Metapi 的模型操练场里先直测一个模型确认聚合模型可正常对话也可以在命令行快速验证# 1. 检查模型列表 curl -sS https://your-domain.com/v1/models -H Authorization: Bearer PROXY_TOKEN | head -50 # 2. 测试对话 curl -sS https://your-domain.com/v1/chat/completions \ -H Authorization: Bearer PROXY_TOKEN \ -H Content-Type: application/json \ -d {model:gpt-4o-mini,messages:[{role:user,content:hi}]}若某模型显示可用但调用失败可展开使用日志查看具体请求路径、失败原因与重试情况配置避坑清单这些坑别踩现象原因与解决客户端报401 / 403误用了AUTH_TOKEN管理令牌请确认填的是PROXY_TOKEN反向代理需透传Authorization头模型列表为空尚未添加站点/账号、账号处于 unhealthy 状态、或未同步 Token到 Token 管理页点「同步」必要时「清除缓存并重建路由」流式输出卡住/截断几乎都是反向代理问题Nginx 加proxy_buffering off;且不要改写text/event-stream类型Base URL 报 404客户端不自动补/v1改成完整路径https://your-domain.com/v1Claude Code 报错ANTHROPIC_BASE_URL误填了带/v1的地址——填根域名即可某模型调用失败查看使用日志可能是通道冷却默认 10 分钟、上游余额不足或模型下线完整排查思路见 docs/faq.md。下一步快速上手10 分钟完成 Metapi 首次部署上游接入添加和管理你的上游中转站配置说明环境变量与下游 Key 策略详解运维手册日志排查与健康检查【免费下载链接】metapi把你在各处注册的 New API / One API / OneHub / DoneHub / Veloera / AnyRouter / Sub2API 等站点 汇聚成 一个 API Key、一个入口自动发现模型、智能路由、成本最优项目地址: https://gitcode.com/gh_mirrors/meta/metapi创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
网站建设高端定制企业官网
RELATED

相关资讯

更多精彩内容,欢迎继续阅读

较早相关资讯

最新相关资讯

gofrs/flock 深度解析:Go 语言线程安全文件锁库及其在 LinuxKit 中的落地实践 2026/9/27 7:24:47

gofrs/flock 深度解析:Go 语言线程安全文件锁库及其在 LinuxKit 中的落地实践

操作系统云原生容器运行时 【免费下载链接】linuxkit A toolkit for building secure, portable and lean operating systems for containers 项目地址: https://gitcode.com/gh_mirrors/li/linuxkit 点击查看 免费下载 flock(github.com/gofrs/flock&a…

阅读更多 →
软考信息安全工程师2024回忆版(解析版) 2026/9/27 7:24:47

软考信息安全工程师2024回忆版(解析版)

1. 信息安全保护等级a. 国家标准《计算机信息系统安全保护等级划分准则(GB17859)》中,将计算机信息安全保护等级分为五级,规定从(第二级)开始要求提供审计安全机制。b. 网络安全等级保护2.0标准中&#xff…

阅读更多 →
如何轻松实现iOS与Android跨平台自动化测试:mobile-mcp完整指南 2026/9/27 7:24:47

如何轻松实现iOS与Android跨平台自动化测试:mobile-mcp完整指南

如何轻松实现iOS与Android跨平台自动化测试:mobile-mcp完整指南 【免费下载链接】mobile-mcp Model Context Protocol Server for Mobile Automation and Scraping (iOS, Android, Emulators, Simulators and Real Devices) 项目地址: https://gitcode.com/GitHub…

阅读更多 →
FluentRead 的 Chrome 内置本地翻译:语言包准备、可用性排查与源码级实现解析 2026/9/27 7:24:40

FluentRead 的 Chrome 内置本地翻译:语言包准备、可用性排查与源码级实现解析

前端AI 应用本地部署 【免费下载链接】FluentRead An open-source browser extension for bilingual translation. 一款开源的浏览器双语翻译插件。 项目地址: https://gitcode.com/gh_mirrors/fl/FluentRead 点击查看 免费下载 导读 本文讲解 FluentRead&#xf…

阅读更多 →
2026最新阿里建站价格揭秘:搞定域名服务器,让网站不再无人问津 2026/9/27 7:24:27

2026最新阿里建站价格揭秘:搞定域名服务器,让网站不再无人问津

2026最新阿里建站价格揭秘:搞定域名服务器,让网站不再无人问津 网站做好了没人访问,这大概是很多甲方对接人最头疼的噩梦。你花了大几万,看着后台数据一片空白,心里直打鼓:是不是钱白花了?其实,很多时候问题不在设计,而在底层的“地基”没打牢。…

阅读更多 →
JavaScript中的隐形闭包陷阱,让我debug到凌晨三点 2026/9/27 7:24:21

JavaScript中的隐形闭包陷阱,让我debug到凌晨三点

凌晨三点,我盯着屏幕上那个看似无害的forEach循环,终于明白为什么我们的Node.js服务会在高并发下内存泄漏——闭包在暗中吞噬了所有内存。这不是我第一次被闭包坑,但绝对是代价最大的一次。 那个该死的内存泄漏 项目是一个实时数据分析服务…

阅读更多 →

今日资讯

本周资讯

本月资讯

看完文章仍有疑问?

联系尧图顾问,获取一对一建站咨询

立即免费咨询 📞 400-888-8888
📞 ✉