接口一览
列表和搜索每页 10 条,
p 从 0 开始。列表里的 key 是打码后的值,要拿到能调用模型的完整密钥,用「取回完整密钥」接口。
创建字段
billing_type 决定这把 Key 能调用哪些模型:按量计费只能调按量模型,按次计费只能调按次模型,按量优先两类都能调。三种模式的区别见计费说明。
创建并取回密钥
下面的脚本创建一把额度 5 美元、30 天有效、只能调用两个模型的 Key,再取回完整密钥。需要requests(python -m pip install requests)。
Authorization: Bearer <key>),前面加不加 sk- 都能用。把它交给下游前保存到你的密钥系统,之后不要频繁调用取回接口,它有严格的频率限制。
修改、禁用和删除
修改时要提交完整的令牌对象:先用GET /api/token/{id} 读出来,改需要的字段,再整体 PUT。只提交几个字段,其他字段可能被重置。
- 禁用或删除后,用这把 Key 调用模型返回 HTTP 401
Invalid token.。 - 调用白名单以外的模型返回 HTTP 403
该令牌无权使用模型:<模型 ID>。
错误处理
常见问题
下游客户用的 Key 会扣谁的钱?
扣你的账户余额。通过remain_quota 给每把 Key 设上限,用完后这把 Key 停止工作,不会继续消耗账户里的其他余额。
怎么统计每把 Key 用了多少?
列表和详情里的used_quota 是这把 Key 累计消耗的额度。要按时间或模型拆分,用日志查询 API 加 token_name 筛选。
用了 model_limits 字段,为什么没生效?
模型白名单只认 models 字段。把允许的模型 ID 用英文逗号连起来写在 models 里。
相关文档
- 获取 AccessToken 与查询余额:余额查询 API
- 按令牌导出调用记录:日志查询 API
- 在控制台创建 Key 与设置 IP 白名单:API Key 如何创建、保存、轮换和撤销?