API Key 余额信息查询

[Ai-Yolo]

目前通过接口可以查询到部分Key信息，而无需对话请求。
可以在后台对Key测试后记录并显示当前查询到的信息。

以下是从代码中提取出的OpenAI官方API接口：

https://api.openai.com/dashboard/billing/subscription
用于获取OpenAI订阅信息的API接口。调用方式和官方其他API一样，该接口需要在请求的Authorization标头中包含密钥。

https://api.openai.com/dashboard/billing/usage
用于获取OpenAI使用情况的API接口。该接口也需要在请求的Authorization标头中包含密钥。
此外，还需要在URL的查询参数中提供起始日期和结束日期，以指定要获取的使用情况的时间范围（例如最近两个月）

formatDate := func(d time.Time) string {
			return fmt.Sprintf("%d-%02d-%02d", d.Year(), d.Month(), d.Day())
		}
		startDate := formatDate(time.Now().AddDate(0, -1, 0))
		endDate := formatDate(time.Now().AddDate(0, 1, 0))
		usageURL := fmt.Sprintf("https://api.openai.com/dashboard/billing/usage?start_date=%s&end_date=%s", startDate, endDate)

[songquanpeng]

Okay，这个最近就会搞。

相关 issue：#45，#59

[songquanpeng]

https://api.openai.com/v1/dashboard/billing/subscription 的返回结果：

{
  "object": "billing_subscription",
  "has_payment_method": false,
  "canceled": false,
  "canceled_at": null,
  "delinquent": null,
  "access_until": 1690848000,
  "soft_limit": 66667,
  "hard_limit": 83334,
  "system_hard_limit": 83334,
  "soft_limit_usd": 4.00002,
  "hard_limit_usd": 5.00004,
  "system_hard_limit_usd": 5.00004,
  "plan": {
    "title": "Explore",
    "id": "free"
  },
  "account_name": "Name",
  "po_number": null,
  "billing_email": null,
  "tax_ids": null,
  "billing_address": null,
  "business_address": null
}

https://api.openai.com/v1/dashboard/billing/usage?start_date=2023-02-16&end_date=2023-05-18 的返回结果：

我还需要搞清楚字段的含义，以及白嫖用户和绑卡用户的区别。

[Ai-Yolo]

是需要绑卡用户的响应内容么？

{
  "object": "billing_subscription",
  "has_payment_method": true,
  "canceled": false,
  "canceled_at": null,
  "delinquent": null,
  "access_until": 1685577600,
  "soft_limit": 300000,
  "hard_limit": 333333,
  "system_hard_limit": 50000000,
  "soft_limit_usd": 18.0,
  "hard_limit_usd": 19.99998,
  "system_hard_limit_usd": 3000.0,
  "plan": {
    "title": "Pay-as-you-go",
    "id": "payg"
  },
  "account_name": "OO",
  "po_number": null,
  "billing_email": null,
  "tax_ids": null,
  "billing_address": {
    "city": "Montana",
    "line1": "1234  Meadow Drive",
    "line2": null,
    "state": "MT",
    "country": "US",
    "postal_code": "59801"
  },
  "business_address": null
}

该字段包含以下信息：

- "object": "billing_subscription"：对象类型为"billing_subscription"，表示这个字段是关于订阅账单的信息。
- "has_payment_method": true：表示该订阅账单有有效的支付方式。
- "canceled": false：表示该订阅账单未被取消。
- "canceled_at": null：表示该订阅账单未被取消，并且没有取消日期。
- "delinquent": null：表示没有关于拖欠款项的信息。
- "access_until": 1685577600：表示订阅的访问权限截止日期，该日期使用时间戳格式表示。
- "soft_limit": 300000：表示软限制的数值，具体含义取决于上下文，可能是指资源使用的某种限制。
- "hard_limit": 333333：表示硬限制的数值，具体含义取决于上下文，可能是指资源使用的某种限制。
- "system_hard_limit": 50000000：表示系统级别的硬限制的数值，具体含义取决于上下文，可能是指系统资源的限制。
- "soft_limit_usd": 18.0：表示软限制的金额，以美元表示。
- "hard_limit_usd": 19.99998：表示硬限制的金额，以美元表示。
- "system_hard_limit_usd": 3000.0：表示系统级别的硬限制的金额，以美元表示。
- "plan": 包含有关订阅计划的信息，如标题和ID。
  - "title": "Pay-as-you-go"：表示订阅计划的标题为"Pay-as-you-go"，即按使用量付费。
  - "id": "payg"：表示订阅计划的ID为"payg"。
- "account_name": "OO"：表示账户名称为"OO"。
- "po_number": null：表示没有关于采购订单号的信息。
- "billing_email": null：表示没有关于账单电子邮件的信息。
- "tax_ids": null：表示没有关于税号的信息。
- "billing_address": 包含有关账单地址的信息。
  - "city": "Montana"：表示账单地址所在城市为"Montana"。
  - "line1": "1234  Meadow Drive"：表示账单地址的第一行为"1234 Meadow Drive"。
  - "line2": null：表示账单地址的第二行为空。
  - "state": "MT"：表示账单地址所在州为"MT"。
  - "country": "US"：表示账单地址所在国家为美国。
  - "postal_code": "59801"：表示账单地址的邮政编码为"59801"。
- "business_address": null：表示没有关于商务地址的信息。

[songquanpeng]

这几个字段我不太清楚到底干嘛的：

  "soft_limit": 300000,
  "hard_limit": 333333,
  "system_hard_limit": 50000000,
  "soft_limit_usd": 18.0,
  "hard_limit_usd": 19.99998,
  "system_hard_limit_usd": 3000.0,

[Ai-Yolo]

"soft_limit": 这个是OpenAI给的授权额度*100,
"hard_limit": 这个可能是可以超额一定范围使用,
"system_hard_limit": 这个应该是目前单账户的付费上限,
"soft_limit_usd": 这个是自行设定的软限制（当您的组织每月达到此使用量阈值时，将发送通知电子邮件。）
"hard_limit_usd": 这个是自行设定的硬限制（当您的组织每月达到此使用量阈值时，后续请求将被拒绝。）
"system_hard_limit_usd": 这个是当前账户可调整的最高额度,

前三个是猜测，不太重要的数据值，可以忽略，后面的是对比我的账户设置判断出来的信息，应该是正确的

[songquanpeng]

Okay，另外这里也有注释可以参考：https://github.com/herobrine19/openai-billing/blob/main/index.html#L226

[Ai-Yolo]

日期查询的结果参数 "total_usage": 12345.9512 这是查询日期范围内消费金额，值/100就是美元

其他的参数就是每天的不同模型使用消费了，可以看情况处理。
使用日期范围查询的时候，需要将结束日期+1天才是正确的。
刷新日期是每个月1号刷新，额度限制都是每月刷新，包括软硬限制和总消费限制

[songquanpeng]

这个刷新日期是固定的吗？

[songquanpeng]

看来是固定的：

[songquanpeng]

已实现。