开始使用 / API 密钥
让你的客户端接入威肯API
创建专用密钥，选择可用分组，再连接你常用的客户端。无需把上游账号或登录凭据交给客户端。
1. 创建自己的 API 密钥
- 登录用户面板 → API 密钥，点击“创建密钥”。
- 填写容易识别的名称，例如“工作电脑”或“测试脚本”，便于之后单独停用。
- 选择账户可用的分组。分组决定可访问的模型与计费规则，不要仅凭名称或图标判断权限。
- 检查有效期、限额等界面提供的选项，确认后创建。
- 按页面提供的方式复制密钥，存入本机客户端或服务端环境变量。不要发到公开聊天、网页或代码仓库。
不同客户端建议使用不同密钥。发现泄露时，在面板停用对应密钥，再创建新的密钥。
2. 填写连接参数
| 字段 | 填写内容 |
|---|---|
| 服务商类型 | OpenAI 兼容接口（仅用于兼容该协议的客户端） |
| Base URL | https://panel.weekendapi.site/v1 |
| API Key | 你在威肯API 创建的密钥 |
| 模型名称 | 当前分组实际可用的模型 ID |
有些客户端自动追加 /v1，这种情况下填写 https://panel.weekendapi.site。避免出现 /v1/v1。Claude 等原生协议需使用客户端对应适配方式，不能把所有协议都当成 OpenAI 请求。
3. 先验证模型列表
将密钥保存在环境变量中后运行以下命令。这里没有真实密钥；不要将含密钥的命令输出发送给他人。
curl https://panel.weekendapi.site/v1/models \
-H "Authorization: Bearer $WEEKENDAPI_KEY"成功返回的模型列表用于确认接口地址和密钥权限。模型列表成功并不等于已验证所有模型；实际请求仍受分组、余额和渠道状态约束。
4. 按报错定位问题
| 现象 | 检查方向 |
|---|---|
| 401 / 未授权 | 密钥是否复制完整、已停用或过期，Authorization 是否为 Bearer 格式。 |
| 模型不存在 / 无权限 | 模型 ID、密钥分组、订阅范围是否一致。 |
| 余额不足 | 回面板核对余额或订阅额度，不要反复重试付费请求。 |
| 429 / 请求过多 | 降低并发，等待后重试，检查客户端是否自动重复请求。 |
| 连接失败 / 404 | 检查 Base URL、重复的 /v1、代理和客户端接口协议。 |