Balance API
Ang Balance API ay nagbibigay-daan sa iyo na kunin ang kasalukuyang balanse ng credits para sa iyong account. Ang endpoint na ito ay nagbibigay ng simpleng paraan upang tingnan ang iyong mga available na credits, na ginagamit para sa iba't ibang serbisyo ng Meshy.
Kunin ang Balanse
Kinukuha ng endpoint na ito ang kasalukuyang balanse ng credits para sa naka-authenticate na user.
Mga Ibinabalik
Nagbabalik ng isang object na naglalaman ng kasalukuyang balanse ng credits. Para sa mga miyembro ng team, ang mga value na ito ay sumasalamin sa shared credit pool ng team.
- Name
- balance
- Type
- integer
- Description
Ang bilang ng mga credits na kasalukuyang available sa iyong account.
- Name
- monthly_credits
- Type
- integer
- Description
Ang bilang ng natitirang credits na mag-e-expire sa susunod na buwanang pag-refresh, gaya ng tinukoy sa
monthly_resets_at.
- Name
- permanent_credits
- Type
- integer
- Description
Ang bilang ng credits na hindi nag-e-expire, tulad ng credits mula sa binili na credit packs o nakuhang rewards.
- Name
- monthly_resets_at
- Type
- timestamp
- Description
Ang oras ng susunod na buwanang pag-refresh ng credits, na ipinahayag bilang Unix timestamp sa milliseconds. Sa oras na ito, nag-e-expire ang kasalukuyang buwanang credits at nare-replenish, kung aktibo ang subscription. Nagbabalik ng
nullkung walang naka-iskedyul na refresh.
Karaniwan, ang balance ay katumbas ng monthly_credits + permanent_credits. Kung may naaangkop na limitasyon ng credit para sa miyembro o workspace sa tumatawag, maaaring mas mababa ang balance.
Request
curl 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
}