FAQ
这里回答第一次使用万模API时最容易混淆的问题。如果你还没跑通过任何请求，建议先看三件套与第一个请求。
万模API 是什么？
万模API 是 AI API 网关。你可以把它理解成一个统一入口：客户端只填一个 Base URL 和一个 API Key，就可以调用多个模型供应商的模型。它不是聊天软件本身，而是给 ChatBox、Cherry Studio、Codex、Dify、你自己的代码等工具使用的接口服务。
什么是中转站？
中转站会把你的请求转发到上游模型服务，并提供统一鉴权、计费、模型路由、日志和限流能力。对用户来说，最明显的变化是：很多客户端原本要填官方 OpenAI / Anthropic 地址，现在改填万模API地址。
第一次使用应该从哪里开始？
按这个顺序：
Base URL 到底填哪个？
大多数 OpenAI 兼容客户端填：
如果客户端会自动拼 /v1，填：
Claude Messages 和 Gemini 原生通常也填 https://www.wanmoapi.com，让客户端或 SDK 自己拼后面的路径。
API Key 是什么？
API Key 是控制台创建的 sk-... 令牌，相当于客户端调用接口的密码。不要发给别人，不要放进公开仓库，不要写在前端页面源码里。
模型名在哪里看？
以控制台可用模型、价格页或 /v1/models 返回为准。客户端里看到的默认模型名不一定在你的分组里可用。
为什么同一个模型在不同客户端表现不同？
常见原因是协议不同、客户端默认参数不同、上下文长度不同、是否开启流式、是否使用工具调用，以及客户端是否正确解析返回。
Chat、Responses、Claude Messages 有什么区别？
- Chat：最通用，桌面聊天客户端和 Dify 常用。
- Responses：Codex 等 Agent 工具常用。
- Claude Messages：Claude Code 和 Anthropic 模式工具常用。
具体看协议选择指南。
如何充值和查看余额？
登录控制台后进入钱包或充值页面，余额和消费记录以控制台为准。文档站不保存订单信息。
是否支持发票？
发票和企业采购以主站公告或客服说明为准，文档站不保存订单信息。
数据会被保存吗？
网关会保留必要的调用日志用于计费、排障和风控。具体数据留存策略以主站隐私政策为准。
可以把 Key 写进前端页面吗？
不建议。API Key 应保存在服务端或可信客户端环境，公开网页中的 Key 很容易泄露。浏览器前端应用建议通过自己的后端转发请求。
为什么在线调试台成功，客户端失败？
这通常说明 Key、余额和模型基本可用，问题在客户端配置。优先检查：
- Base URL 是否多写或少写
/v1。 - 协议是否选错。
- 模型名是否手动添加。
- 客户端是否开启了不兼容参数。
Codex 为什么不能按普通聊天客户端配置？
Codex 更适合走 Responses API。它需要处理工具调用、流式事件和任务状态。普通 Chat Completions 兼容层可能让认证通过，但任务执行中途失败。
Windows、macOS、Linux 步骤为什么不同？
主要差异在终端、环境变量和安装工具：
- Windows PowerShell 读取变量用
$env:WANMO_API_KEY。 - macOS / Linux / WSL 读取变量用
$WANMO_API_KEY。 - Windows 常用
winget，macOS 常用安装包或 Homebrew，Linux 常用发行版包管理器。
我不会命令行怎么办？
先用网页在线调试台验证 Key，再使用 ChatBox 或 Cherry Studio 这类图形客户端。只有 Codex、Claude Code、Cline CLI、自写代码时才强依赖命令行。
请求失败时应该发什么信息给客服或管理员？
请准备：
- 客户端名称和版本。
- 操作系统。
- Base URL 截图。
- 模型名。
- 控制台调用日志里的错误。
- 在线调试台是否能成功。