aisplice

API 参考

余额

GET/v1/balance

返回账户余额和当前 API key 还能花多少，单位美元。免费、只读：不调用模型，不扣费。额度用完或已过期的 key 也能查，只有被禁用的 key 会被拒绝。

#请求参数

  • Authorizationheader必填

    Bearer sk-YOUR_KEY。没有请求体，也没有查询参数。

balance 是整个账户的钱包余额，大任务结算后可能变成负数。available 是这个 key 现在还能花的钱：取 balance 和 key 自身剩余额度中较小的一个，最低为 0。key 没有单独限额时 key.remaining 为 null；expires_at 为 0 表示永不过期。

B 端可以在提交任务前先查一下，available 不够时提醒自己的团队充值。开启请求签名后，和这个 key 的其他请求一样签名，签名路径用 /v1/balance。

#相关错误码

  • 401key 缺失、无效或已禁用；开启请求签名后，签名缺失或不对也会返回 401。
  • 403账户已被禁用。
  • 500暂时读不到余额，几秒后重试。

完整错误码表 →

#请求示例

curl https://www.aisplice.store/v1/balance \
  -H "Authorization: Bearer sk-YOUR_KEY"

#响应

response.json
{
  "object": "balance",
  "currency": "USD",
  "balance": 12.5,
  "available": 2,
  "key": {
    "name": "app",
    "unlimited": false,
    "remaining": 2,
    "used": 1,
    "expires_at": 0
  }
}

还是没解决？

把请求 ID 或报错信息发给我们，我们来查。

上一页文件上传策略接下来模型列表