接入文档

是同一类东西，叫法不同。社区里常说的 AI API 中转站、API 中转、大模型中转，指的都是横在你的工具和各家模型厂商之间的那一层：你只对接它一个地址，它负责把请求转发到 OpenAI、Anthropic、Google 等上游，并把不同厂商的协议差异抹平。XylemNode 就是这样一层，我们在文档里习惯称它为网关。

按顺序核对三件事：接口地址是否符合该工具要求、密钥有没有填错或漏字、模型名与后台是否一致。多数工具改完配置要重启（或重开终端）才生效。

看工具用的协议。走 OpenAI 兼容格式的（Codex、Cursor、OpenCode、Cline、Continue 等）通常要带 /v1；Claude Code（以及跑在它上面的 work-buddy）、Gemini CLI 用各自原生协议，不加 /v1；Cherry Studio 和 CC Switch 的统一供应商只填到域名，由它们自己补路径。每份工具指南里都标了对应写法。

说明填的模型名不在这把 Key 能调用的范围内：要么模型名写错了，要么这把 Key 的分组里没有它。以控制台的可用列表为准，注意大小写和完整标识（含版本号、前缀等），别用简称。

基本都是密钥问题：填错、复制时带了空格、已失效，或用环境变量配置时没重开终端导致没生效。重新核对密钥，并到控制台确认这把密钥仍是启用状态、没有过期。

多半是接口地址的层级不对，两种写错的表现不一样：该带 /v1 的没带，请求会落到网站页面上，返回的是一整页网页，客户端报无法解析响应（比如 Unexpected token '<'）；反过来多拼了一层（如 /v1/v1），才会报 404 Invalid URL。对照该工具指南把地址填到正确层级，也别手动多加 /chat/completions 这类后缀，多数工具会自动补。

地址不用改，把模型名换成目标模型即可；前提是这把 Key 的分组里有这个模型，没有的话换一把对应分组的 Key。少数工具还要先把新模型加进自己的模型列表：OpenCode、OpenClaw 在配置文件的 models 里加一项，Dify、Coze Studio 再添加一个模型；aider 记得保留 openai/ 前缀。

以控制台的可用模型列表为准，每个模型都标了它所在的分组，Key 的分组决定它能调用哪些；支持 /v1/models 的工具也能自动拉取这把 Key 可用的模型。按列表里的完整标识填写最稳妥。

可以。密钥和具体工具无关，你能在多个客户端、多台机器上共用同一个密钥，credits 都从同一个账户扣。

充值按 1:1 到账，充多少就是多少 credits；月卡的 credits 在开通时一次到账，在一个月有效期内使用。两者合并在同一账户里，按实际用量扣减。调用失败时先确认余额是否充足、模型是否在这把 Key 的分组里。

先确认本机网络能正常访问 api.xylemnode.com；公司网络、防火墙或代理有时会拦截或拖慢请求。排除网络因素后仍慢，可换个模型或稍后重试。