額度餘額

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	發生意外內部錯誤。

本頁面對您有幫助嗎？