查询openai账号余额的接口的进一步展开说明

一、问题的背景

ChatGPT目前很受欢迎，OpenAI为新注册用户赠送5美元。因此，许多人选择使用新注册账号来调用API，以获得一些不要钱的资源。

作为开发者，我们特别关注的一个问题是如何通过接口实时查询OpenAI账号的余额。

但是，遗憾的是，OpenAI官方目前并未提供直接查询账户余额的API。

二、几个查询余额的方案

1、直接在后台查询

最原始的方式是通过OpenAI官方提供的后台查看余额，链接为：https://platform.openai.com/account/usage。

这类方法适用于普通用户，但需要登录并使用梯子（由于访问可能受限），对开发者来讲意义不大。

2、隐藏的接口【已不可用】

曾有一些朋友发现了一个隐藏的接口：api.openai.com/dashboard/b...，可以通过发送GET要求，将Token（API密钥）添加到Header中来查询余额。之前，该接口会直接返回类似以下结果：

{ 
  "object" : "credit_summary",
  "total_granted" : 18.0,
  "total_used" : 0.6284545,
  "total_available" : 17.3715455,
  "grants" : {
    "object" : "list",
    "data" : [{
      "object" : "credit_grant",
      "id" : "bdb804***********************ff0132",
      "grant_amount" : 18.0,
      "used_amount" : 0.6284545,
      "effective_at" : 1673740800.0,
      "expires_at" : 1682899200.0
    }]
  }
}

但是，现在该方法已失效，需要使用会话密钥（session key），因此该方法不再可行。

3、最新的方案

通过抓包分析，我们可使用其他接口来实现查询余额的目标。

这个接口一样是发送GET要求，需要在Header中添加Token（API密钥）。返回结果以下：

{ 
  "object" : "billing_subscription",
  "has_payment_method" : true,
  "canceled" : false,
  "canceled_at" : null,
  "delinquent" : null,
  "access_until" : 1690848000,
  "soft_limit" : 1600000,
  "hard_limit" : 2000000,
  "system_hard_limit" : 2000000,
  "soft_limit_usd" : 96.0,
  "hard_limit_usd" : 120.0,
  "system_hard_limit_usd" : 120.0,
  "plan" : {
    "title" : "Pay-as-you-go",
    "id" : "payg"
  },
  "account_name" : "xxdwe",
  "po_number" : null,
  "billing_email" : null,
  "tax_ids" : null,
  "billing_address" : {},
  "business_address" : null
}

还可使用另外一个接口来查询指定日期范围内的使用明细。一样是发送GET要求，并在Header中添加Token（API密钥），返回结果以下：

{ 
  "object" : "list",
  "daily_costs" : [
    {
      "timestamp" : 1681948800.0,
      "line_items" : [
        { "name" : "Instruct models", "cost" : 0.0 },
        { "name" : "Chat models", "cost" : 0.0 },
        { "name" : "GPT⑷", "cost" : 0.0 },
        { "name" : "Fine-tuned models", "cost" : 0.0 },
        { "name" : "Embedding models", "cost" : 0.0 },
        { "name" : "Image models", "cost" : 0.0 },
        { "name" : "Audio models", "cost" : 0.0 }
      ]
    }
  ],
  "total_usage" : 5956.9476
}

结合这两个接口，我们就能够实现查询余额的目标了。

三、在线网页查询

基于上述第三个方案，我创建了一个在线查询站点，方便大家使用，而且无需使用梯子。站点链接：gptbill.lonlie.cn。

通过以上几种方法，我们现在可以方便地查询OpenAI账户的余额。

查询openai账号余额的接口的常见问答Q&A