跳转到主要内容
GET
余额查询

接口信息

此接口没有请求参数,只需携带认证头。

1. 认证

所有请求都必须在 HTTP Header 中携带 Bearer 凭证。支持两种凭证,任选其一:
以下情况视为认证失败:凭证缺失或错误、凭证已删除或禁用、账号已禁用。

2. 通用响应结构

业务状态码

请以响应体中的 code 判断请求是否成功。

金额格式

  • 所有金额都以**美元(USD)**表示,类型为 string,避免浮点精度丢失。
  • 余额类金额固定保留 4 位小数,例如 "986.9275"。
  • 模型单价按实际价格输出,不补末尾的 0,例如 "40"、"2.5"、"0.00075"。

3. 余额查询

根据凭证类型返回不同结构,可以用 data.type 区分。

3.1 使用系统访问令牌:返回账号余额(type = account)

企业子账号只返回该子账号自己的余额,不包含企业其他成员。

3.2 使用 API 密钥:返回该密钥的额度(type = token)

不限额度的密钥(unlimited = true)不受密钥额度约束,balance 可能显示为负数,这种情况请以 usedAmount 作为该密钥的用量参考,实际可用金额以账号余额为准。

4. 调用示例


5. 注意事项

  1. 数据刷新:余额数据最长约 1 分钟刷新一次,充值或消费后可能稍有延迟。
  2. 以实际扣费为准:本接口用于查询和预估,最终费用请以账单为准。
  3. 妥善保管凭证:系统访问令牌可以查询整个账号的信息,请勿泄露;如果只需要查询某个密钥的额度,建议使用对应的 API 密钥调用。