API 參考

餘額

GET/v1/balance

回傳帳戶餘額和目前 API key 還能花多少，單位美元。免費、唯讀：不呼叫模型，不扣費。額度用完或已過期的 key 也能查，只有被停用的 key 會被拒絕。

#請求參數

Authorizationheader必填
Bearer sk-YOUR_KEY。沒有請求主體，也沒有查詢參數。

balance 是整個帳戶的錢包餘額，大任務結算後可能變成負數。available 是這個 key 現在還能花的錢：取 balance 和 key 自身剩餘額度中較小的一個，最低為 0。key 沒有單獨限額時 key.remaining 為 null；expires_at 為 0 表示永不過期。

企業客戶可以在提交任務前先查一下，available 不夠時提醒自己的團隊儲值。開啟請求簽名後，和這個 key 的其他請求一樣簽名，簽名路徑用 /v1/balance。

#相關錯誤碼

401key 缺失、無效或已停用；開啟請求簽名後，簽名缺失或不對也會回傳 401。
403帳戶已被停用。
500暫時無法讀取餘額，幾秒後重試。

完整錯誤碼表 →

#請求範例

curl https://www.aisplice.store/v1/balance \
  -H "Authorization: Bearer sk-YOUR_KEY"

#回應

response.json

{
  "object": "balance",
  "currency": "USD",
  "balance": 12.5,
  "available": 2,
  "key": {
    "name": "app",
    "unlimited": false,
    "remaining": 2,
    "used": 1,
    "expires_at": 0
  }
}

還是沒解決？

把請求 ID 或錯誤訊息傳給我們，我們來查。