额度余额

Name: SRTGen
Rating: 4.9 (10000 reviews)

查询您当前可用的额度余额，以管理使用情况并防止作业失败。

GET/api/v1/balance

快速实现

curl -X GET https://api.srtgen.com/api/v1/balance \
  -H "x-api-key: <YOUR_API_KEY>"

GEThttps://api.srtgen.com/api/v1/balance

此端点返回总可用余额，包括您的每月订阅配额和您购买的任何额外充值额度。

响应结构

参数	类型	是否必填
身份与上下文
`user`	对象	经过身份验证的用户基本信息。
`user.name`	类型	用户的显示名称。
`user.email`	类型	注册的电子邮件地址。
额度余额明细
`credits`	对象	详细的额度余额细目。
`credits.totalBalance`	Number	所有可用额度之和 (配额 + 额外)。
`credits.extraCredits`	Number	永久充值额度。
`credits.plans`	Array	活动订阅计划列表。
`plans[].name`	类型	计划显示名称 (例如 'Pro Plan')。
`plans[].status`	类型	订阅状态 (active, past_due)。
`plans[].balance`	Number	此特定周期内剩余的额度。
云存储使用情况
`storage`	对象	云存储使用统计。
`storage.usage`	Number	当前存储使用量 (字节)。
`storage.limit`	Number	基于您计划的最大存储限制 (字节)。
`storage.formattedUsage`	类型	人类可读的使用量 (例如 '200 MB')。
`storage.formattedLimit`	类型	人类可读的限制 (例如 '10 GB')。

响应示例: 200 OK

{
  "success": true,
  "user": {
    "name": "Alex Rivera",
    "email": "[email protected]"
  },
  "credits": {
    "totalBalance": 1250,
    "totalMonthlyCredits": 1000,
    "extraCredits": 250,
    "plans": [
      {
        "id": "starter",
        "name": "Starter Plan",
        "status": "active",
        "balance": 1000,
        "total": 1000,
        "resetTime": "2026-04-29T17:48:46.000Z"
      }
    ]
  },
  "storage": {
    "usage": 209715200,
    "limit": 10737418240,
    "formattedUsage": "200 MB",
    "formattedLimit": "10 GB"
  },
  "updatedAt": "2026-03-29T17:48:46.000Z"
}

错误

状态	错误代码	描述
401	unauthorized	API 密钥缺失或无效。
500	server_error	发生意外内部错误。

本页面对您有帮助吗？