Balance API
Balance API 允許您取得帳戶目前的 credit balance。此 endpoint 提供了一種簡單的方式來查看您可用的積分，這些積分可用於各種 Meshy 服務。
GET/openapi/v1/balance
取得餘額
此 endpoint 用於取得已驗證使用者目前的 credit balance。
回傳值
回傳一個包含目前 credit balance 的物件。對於團隊成員而言，這些值反映的是團隊共享的 credit 池。
- Name
- balance
- Type
- integer
- Description
您帳戶中目前可用的積分數量。
- Name
- monthly_credits
- Type
- integer
- Description
將在下一次月度重置（由
monthly_resets_at指定）時過期的剩餘積分數量。
- Name
- permanent_credits
- Type
- integer
- Description
不會過期的積分數量，例如透過購買 credit 包或獲得獎勵所得的積分。
- Name
- monthly_resets_at
- Type
- timestamp
- Description
下一次月度 credit 重置的時間，以毫秒為單位的 Unix 時間戳表示。在此時間點，只要訂閱處於有效狀態，目前的月度積分將過期並重新補充。如果未排定重置，則回傳
null。
通常情況下，balance 等於 monthly_credits + permanent_credits。如果呼叫者受到成員或工作區 credit 限制的約束，balance 可能會更低。
Request
GET
/openapi/v1/balancecurl https://api.meshy.ai/openapi/v1/balance \
-H "Authorization: Bearer ${YOUR_API_KEY}"
Response
{
"balance": 1000,
"monthly_credits": 600,
"permanent_credits": 400,
"monthly_resets_at": 1793491200000
}