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），仅供参考
