常见问题
常见问题
关于接入、计费、稳定性与数据安全的常见疑问。找不到答案可以在控制台提交工单， 或发邮件到 support@admesh.ai。
产品与接入
- Admesh.ai 是什么？
- Admesh.ai 是一个大模型聚合网关。它把 Claude、GPT、DeepSeek、Qwen、GLM、Kimi、Gemini、MiniMax 等主流模型封装成统一的 OpenAI 兼容接口，你只需要一个 Base URL 和一把 API Key，就能在它们之间切换。
- 接入需要改多少代码？
- 通常只需要改三处：Base URL、API Key、模型名。现有的 OpenAI SDK 调用方式、消息结构、流式处理逻辑都不需要改。如果你用的是 Anthropic 原生协议，我们也提供兼容端点。
- Base URL 是什么？
- https://api.admesh.ai/v1 。所有模型共用这一个地址，通过请求体里的 model 字段选择具体模型，模型名格式为 namespace/model，例如 anthropic/… 或 openai/…。
- 支持哪些客户端和框架？
- 任何允许自定义 Base URL 的 OpenAI 兼容客户端都可以，包括 LangChain、LlamaIndex、Cursor、Cherry Studio、Claude Code、Codex CLI 等。文档站提供了各客户端的逐步接入说明。
模型与路由
- 模型名一直变，我该怎么选？
- 以控制台模型目录或公开的 /v1/models 接口为准，那里是当前实际可用的模型清单与价格。建议不要在任何代码里硬编码模型名，而是放到配置里，换模型只改配置。
- 请求一个模型时，会被偷偷换成另一个模型吗？
- 不会。容灾切换只在同一个 public_model 的通道池内进行——你请求 Claude，返回的一定是 Claude。跨模型替换会直接改变输出质量，这不是网关可以替你做的决定。
- 上游故障时会发生什么？
- 网关会在同一模型的多个通道之间自动切换：连接失败、超时、429、5xx 都会触发切换；连续失败达到阈值时该通道进入熔断状态，暂停接收流量并定期探测恢复。
计费与账户
- 怎么计费？额度会过期吗？
- 纯按量计费，按实际 Token 用量结算，没有月租和强制订阅。充值额度永久有效，不做月度清零。详见价格页。
- 调用失败会扣费吗？
- 未产生上游输出的失败请求不计费，包括参数错误、鉴权失败、余额不足和限流。流式响应中已经输出部分内容后中断的，已产生的输出会如实计费。
安全与数据
- 会保存我的 Prompt 和模型输出吗？
- 默认不持久化 Prompt 与模型输出正文。用量日志只记录请求元数据、Token 数、模型、金额、错误码与延迟，用于计费与排障。
- API Key 是怎么存的？
- 服务端只保存 Key 的哈希值与前缀/末四位用于展示，明文只在创建成功的那一刻展示一次，之后无法再次读取。Key 被删除后会在数十秒内失效。
- 上游密钥会暴露吗？
- 不会。上游凭证只保存在加密存储中，不会进入日志、不会进入浏览器代码，也不会出现在任何对外接口里。