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），仅供参考
企业数字化 ERP 产品动态
相关推荐
AD22智能PDF实战指南：位号图与丝印图高效导出 /* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/27 1:52:57
FindSomething：前端敏感信息泄漏实时扫描工具 /* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/27 1:52:57
泰山派Ubuntu下MIPI屏配置指南：设备树、触摸与竖屏调校 /* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/27 1:52:57
识光CIOE亮相：SPAD-SoC三大产品线如何勾勒单光子感知的量产路径 在刚刚落幕的中国国际光电博览会（CIOE）上，苏州识光芯科技术有限公司（识光，Sophoton）携多款SPAD-SoC新品亮相。从单点、线阵到面阵，三条产品线并非孤立展示，而是呈现出一种清晰的技术逻辑：以全芯片化架构为底座，用不同形态的芯片去接住高度分化的产业需求。
统一技术… · 2026/9/27 2:34:03
3步搞定app开发人员网站被黑挂马怎么选安全方案 3步搞定app开发人员网站被黑挂马怎么选安全方案 半夜三点，手机突然弹出短信：“您的网站www.yourapp.com存在恶意代码”。你慌了神，点开后台，发现首页被替换成了博彩广告，SEO收录瞬间归零。这种 网站被黑挂马不知道怎么办… · 2026/9/27 2:34:03
国企干部民主评议场景，衡识人才测评等360评估系统适配 引文/摘要又到年终干部考核季。不少国企组织人事部门都在面对同一道题：民主评议怎么搞，才能既合规又高效，还能真正沉淀出有用的数据？传统纸票模式下，评议结果常常“评完就归档”，难以支撑干部选拔与梯队建设… · 2026/9/27 2:33:57
立创EDA安装全攻略：专业版与标准版选型及避坑指南 /* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/27 2:33:57
Vue 全局事件总线详解 一、什么是事件总线
1.1 定义
事件总线(Event Bus)本质上就是一个居中转发消息的"邮局":发送方不直接找接收方,而是把消息丢给总线,总线再帮转给所有订阅了这个消息的人。
在 Vue 里,它用来解决任意两个组件之间通信的问题,不限于父子,不限于兄弟,只要挂在同一条总线… · 2026/9/27 2:33:57
PADS Logic到OrCAD转换全流程：工具迁移、网表关联与高频问题排查 /* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/27 2:33:51
MATLAB雷达信号脉冲压缩仿真：LFM线性调频、匹配滤波与距离分辨率实现 简介：这套Matlab仿真工具完整呈现雷达信号脉冲压缩过程，从线性调频（LFM）信号生成、目标回波仿真到匹配滤波压缩处理均有可运行代码支撑，面向电子信息工程、计算机、数学等专业学生，适用于课程设计、期末大作… · 2026/9/27 0:00:01
汕头网站建设制作厂家避坑指南：5大注意事项救急 汕头网站建设制作厂家避坑指南：5大注意事项救急 改个需求建站公司拖一周，这种憋屈事我见得太多了。 很多汕头老板找本地建站团队，签合同前看着方案挺美，一上线就变脸。 今天不聊虚的，直接拆解找 汕头网站建设制作厂家 时的5个核心 注意事项… · 2026/9/27 0:00:01
多模态虚假新闻检测实战：BERT+ResNet双塔与对比学习 简介：基于PyTorch的多模态虚假新闻检测项目完整代码包，面向自然语言处理与计算机视觉交叉方向的开发者、科研人员及毕业设计选题者，解决社交媒体中文本与图像联合识别虚假新闻的问题。系统以BERT预训练模型提取文本语义特征，以Res… · 2026/9/27 0:00:01
MATLAB雷达信号脉冲压缩仿真：LFM线性调频、匹配滤波与距离分辨率实现 简介：这套Matlab仿真工具完整呈现雷达信号脉冲压缩过程，从线性调频（LFM）信号生成、目标回波仿真到匹配滤波压缩处理均有可运行代码支撑，面向电子信息工程、计算机、数学等专业学生，适用于课程设计、期末大作… · 2026/9/27 0:00:01
汕头网站建设制作厂家避坑指南：5大注意事项救急 汕头网站建设制作厂家避坑指南：5大注意事项救急 改个需求建站公司拖一周，这种憋屈事我见得太多了。 很多汕头老板找本地建站团队，签合同前看着方案挺美，一上线就变脸。 今天不聊虚的，直接拆解找 汕头网站建设制作厂家 时的5个核心 注意事项… · 2026/9/27 0:00:01
多模态虚假新闻检测实战：BERT+ResNet双塔与对比学习 简介：基于PyTorch的多模态虚假新闻检测项目完整代码包，面向自然语言处理与计算机视觉交叉方向的开发者、科研人员及毕业设计选题者，解决社交媒体中文本与图像联合识别虚假新闻的问题。系统以BERT预训练模型提取文本语义特征，以Res… · 2026/9/27 0:00:01
