Skip to main content
GET
  • 查詢當前用戶賬戶的總體餘額
  • 監控用戶級別的使用情況
  • 支持 CORS 跨域請求
  • 實時餘額監控
獲取當前用戶賬戶的剩餘餘額和已使用餘額。此接口返回用戶級別的餘額信息,與具體令牌無關,用於查看用戶賬戶的總體餘額,同時會返回積分字段,固定按 1 USD = 200 積分 換算。

Authorizations

string
必填
所有接口均需要使用 Bearer Token 進行認證獲取 API Key:訪問 API Key 管理頁面 獲取您的 API Key使用時在請求頭中添加:

接口端點

兩個端點功能相同,可以任選其一使用。

Response

boolean
請求是否成功
string
錯誤信息(僅失敗時返回)
float
用戶剩餘餘額(成功時返回)。當 unlimited_quotatrue 時,該值爲 -1
float
用戶已使用餘額(成功時返回)
float
用戶剩餘積分(成功時返回),固定按 1 USD = 200 積分 換算
float
用戶已使用積分(成功時返回)
float
積分換算比例,當前返回 200
boolean
是否爲無限額度用戶。true 表示無限額度,false 表示有限額度

令牌餘額 vs 用戶餘額

使用場景

  • 查看用戶賬戶的總體餘額
  • 用於充值提醒和餘額告警
  • 在用戶控制面板顯示賬戶餘額
餘額單位說明餘額數值的單位取決於系統配置:
  • USD - 美元
  • CNY - 人民幣
  • Tokens - Token 數量
如果需要穩定讀取積分,請優先使用 remain_creditsused_credits。這兩個字段固定按 1 USD = 200 積分 換算,不受餘額展示配置影響。
無限額度用戶當用戶被設置爲無限額度時:
  • unlimited_quota 字段返回 true
  • remain_balance 字段返回 -1
  • 該用戶不受額度限制,可無限使用

常見錯誤

安全提示API Key 相當於密碼,請妥善保管,不要泄露給他人。生產環境請務必使用 HTTPS。