鉴权与 API Key

OpenAI 兼容鉴权

请求头使用完整密钥，不在 URL 查询参数中传递。

Authorization: Bearer YOUR_WUDI_API_KEY
Content-Type: application/json

在客户端的 API Key 输入框中只填写密钥本体，不要再次添加 Bearer 。SDK 会自行构造请求头。

Anthropic 兼容鉴权

使用支持 Messages 的模型和渠道时，可按客户端要求设置 x-api-key 与版本头：

x-api-key: YOUR_WUDI_API_KEY
anthropic-version: 2023-06-01
content-type: application/json

Claude Code 若使用 ANTHROPIC_AUTH_TOKEN，客户端会发送 Bearer 鉴权。不要同时配置多个相互冲突的认证变量。具体设置见 Claude Code 与 Messages API。

密钥能调用哪些模型

密钥会受到其所属账户、所选分组、模型白名单、密钥额度、过期时间及 IP 限制（如设置）的共同约束。一个 Key 并不天然获得整个模型广场的全部权限。调用 GET /v1/models 查看当前可见 ID，再尝试目标协议。

常见鉴权错误

现象	优先检查
401 / invalid token	是否复制完整、是否含空格、密钥是否删除或过期
403 / permission denied	分组、模型限制、IP 限制
额度不足	账户余额与密钥剩余额度都要检查
客户端能连接但模型失败	测试按钮可能只访问模型列表，继续检查模型 ID 与协议

密钥管理

为不同客户端分别创建密钥，便于停用与对账。公开仓库、网页前端和教程截图使用占位符。密钥意外泄露时，立即停用旧 Key 并创建新 Key；仅修改登录密码不能代替撤销 API Key。

如果在服务端应用中使用 .env，将它加入版本控制忽略规则。前端用户请求先发送到你的服务端，再由服务端调用 WuDi API。