余额查询
余额查询
TLDR：查询账户的总额度和已用额度，计算剩余余额。
查询总额度
请求
GET /v1/dashboard/billing/subscription请求头
| 请求头 | 必填 | 说明 |
|---|---|---|
Authorization | 是 | Bearer sk-your-api-key，使用你的 API Key 进行认证 |
示例
响应
{
"object": "billing_subscription",
"has_payment_method": true,
"soft_limit_usd": 100.00,
"hard_limit_usd": 100.00
}响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
soft_limit_usd | number | 总额度（单位：人民币 ¥，字段名为历史兼容） |
hard_limit_usd | number | 硬限制额度 |
💡 注意：字段名含 _usd是 OpenAI 格式兼容遗留，实际金额单位为 CNY（人民币）。
查询已用额度
请求
GET /v1/dashboard/billing/usage请求头
| 请求头 | 必填 | 说明 |
|---|---|---|
Authorization | 是 | Bearer sk-your-api-key，使用你的 API Key 进行认证 |
示例
响应
{
"object": "list",
"total_usage": 5000
}响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
total_usage | number | 已用额度（单位：分，需除以 100 换算为元） |
计算剩余余额
剩余余额（¥）= soft_limit_usd - total_usage / 100soft_limit_usd = 100.00total_usage = 5000（即 50.00 元）100.00 - 5000 / 100 = 50.00 元Python 示例
Node.js 示例
错误处理
401 Unauthorized
{
"error": {
"message": "Invalid authentication credentials. Please check your API key.",
"type": "authentication_error",
"code": "invalid_api_key"
}
}403 Forbidden
{
"error": {
"message": "You do not have permission to access this resource.",
"type": "authorization_error",
"code": "forbidden"
}
}注意事项
insufficient_quota 错误