API 参考/余额与用量
余额、调用记录与用量
用当前 API Key 查询账户余额、调用记录、用量汇总和 Key 信息。
下面的接口使用当前 API Key 查询,Bearer 或 x-api-key 都可以。生产 API Key 默认按 key id 隔离:Key A 发起的请求不会出现在 Key B 的查询结果中,即使两个 Key 属于同一个账号。调用记录只开放 page 参数,后台固定每页 20 条。
本页内容expand_more
账户余额link
GET
/v1/dashboard/balance返回 API Key 所属账户级余额;同一账户下的多个 API Key 共享该余额,并非每个 Key 独立计余额。普通账户返回 availableUsd 和 reservedUsd;采购单 Key 返回该订单的预付可用、预留与已结算金额,并标记 source: "market_order"。
Request Recordslink
GET
/v1/requests?page=1分页返回当前 API Key 最近 90 天内的调用记录,页大小由后台固定为 20 条,用户不能通过 limit 调整。返回公开字段,包括请求 ID、模型、状态、时间、token、费用、API Key 名称和 masked key。
Usage Summarylink
GET
/v1/usage聚合当前 API Key 的请求数、成功/失败数、费用合计、输入 token 和输出 token。统计范围与 /v1/requests 一致。
API Key 信息link
GET
/v1/key返回当前 API Key 的累计用量、最近 24 小时、7 天和 30 天的滚动用量,以及当前额度上限和剩余额度。