外观
令牌（API Key）
令牌就是调用 API 使用的密钥（sk- 开头）。一个账户可以创建多个令牌，分别用于不同的应用或分组。
创建令牌
进入 控制台 → 令牌，点击「添加令牌」，各字段含义如下：
| 字段 | 说明 |
|---|---|
| 名称 | 便于区分用途，如 claude-code、my-app |
| 分组 | 决定可用模型和价格，见 分组与计费。选择 auto 则自动匹配 |
| 额度 | 该令牌最多可以消费的额度；也可以勾选「无限额度」 |
| 过期时间 | 到期后令牌自动失效；可设置为永不过期 |
| 模型限制 | 可选。开启后该令牌只能调用列表中的模型 |
| IP 限制 | 可选。只允许指定 IP 使用该令牌，适合服务器端固定出口 IP 的场景 |
创建后在列表中复制密钥即可使用。修改令牌的分组、额度等设置后立即生效，密钥本身不变。
建议一个用途一个令牌
为不同的应用或工具分别创建令牌，并设置合理的额度上限。这样既能在日志中区分用量，某个密钥泄露时也只需删除这一个。
在请求中使用
| 接口格式 | 请求头 |
|---|---|
| OpenAI 兼容 | Authorization: Bearer sk-xxx |
| Claude Messages | x-api-key: sk-xxx 或 Authorization: Bearer sk-xxx |
| Gemini 原生 | x-goog-api-key: sk-xxx，或在 URL 上加 ?key=sk-xxx |
查询令牌余额
- 网页查询：打开 usage.144096.xyz，输入令牌即可查看额度与用量。
- 控制台：令牌 页面显示每个令牌的剩余额度，使用日志 显示每次请求的扣费。
- 接口查询：使用 OpenAI 兼容的账单接口，只需令牌本身即可调用，详见 查询令牌额度。
bash
curl https://vip.zen-ai.top/v1/dashboard/billing/subscription \
-H "Authorization: Bearer $VIP_API_KEY"令牌额度与账户余额
- 令牌额度是该令牌的消费上限，每次请求会同时扣减令牌额度和账户余额。
- 账户余额不足时，即使令牌还有额度，请求也会失败；令牌额度用完时，即使账户有余额，该令牌也会停用。
- 两种情况分别需要「充值」或「在控制台调高令牌额度 / 设为无限额度」。
安全建议
- 不要把密钥写进前端网页、移动端安装包或公开的代码仓库，应放在服务端环境变量中。
- 为令牌设置额度上限和过期时间；服务器端使用时可开启 IP 限制。
- 发现泄露后立即在控制台删除该令牌并重新创建。
- 需要通过程序批量管理令牌时，可使用 管理接口。