#认证与令牌

万模API 使用令牌进行鉴权。你可以把令牌理解成“给客户端使用的密码”：客户端每次请求模型时都会带上它，平台用它判断是谁在调用、能用哪些模型、是否还有额度。

#你需要知道的几个词

#推荐创建流程

1. 打开控制台并登录。
2. 进入令牌管理或 API Key 管理。
3. 点击新建令牌。
4. 名称写清用途，例如 chatbox-home、codex-dev、dify-prod。
5. 选择分组。第一次不确定时，选择能访问常用文本模型的默认分组。
6. 设置额度。测试令牌建议设置较小额度，生产应用再单独建令牌。
7. 保存并复制 sk-...。
8. 立刻用在线调试台发一条测试请求。

#令牌命名建议

#鉴权头怎么写

OpenAI 兼容接口使用 Bearer Token：

Authorization: Bearer sk-...

Linux/macOS（Bash）的 curl 示例：

curl https://www.wanmoapi.com/v1/models \
  -H "Authorization: Bearer $WANMO_API_KEY"

Claude Messages 协议通常也可以使用 Bearer；部分 Anthropic 原生客户端要求 x-api-key：

x-api-key: sk-...
anthropic-version: 2023-06-01

如果客户端有单独的 API Key 输入框，不需要自己写 Authorization: Bearer，只粘贴 sk-... 即可。

#Windows / macOS / Linux 保存方式

#Windows PowerShell

当前窗口临时生效：

$env:WANMO_API_KEY="sk-..."

长期保存到当前用户：

[Environment]::SetEnvironmentVariable("WANMO_API_KEY", "sk-...", "User")

验证：

echo $env:WANMO_API_KEY

#macOS / Linux / WSL

当前终端临时生效：

export WANMO_API_KEY="sk-..."

长期保存到 zsh：

echo 'export WANMO_API_KEY="sk-..."' >> ~/.zshrc
source ~/.zshrc

如果你使用 Bash：

echo 'export WANMO_API_KEY="sk-..."' >> ~/.bashrc
source ~/.bashrc

#最小验证

验证 Key 是否可用，优先用 /v1/models，因为它请求体最简单：

#Linux/macOS（Bash）的 curl 的模型列表

curl https://www.wanmoapi.com/v1/models \
  -H "Authorization: Bearer $WANMO_API_KEY"

#Windows PowerShell 的 curl 的模型列表

curl.exe https://www.wanmoapi.com/v1/models `
  -H "Authorization: Bearer $env:WANMO_API_KEY"

成功时你会看到模型列表或模型相关 JSON。失败时按下面排查。

#常见错误

#使用建议

• 为不同应用创建不同令牌，方便单独停用和查看日志。
• 不要复用生产令牌做本地测试。
• 编码工具、Dify、自动化脚本建议设置额度上限。
• 如果怀疑 Key 泄露，立即停用旧令牌并创建新令牌。
• 排障时先看控制台调用日志，再看客户端报错。

下一步：协议选择指南