Ireretiro ang lowpoly sa Oct 30, 2026. Lumipat ng modelo bago ang mga petsang ito para maiwasan ang mga error sa request.

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.


GET/openapi/v1/balance

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 null kung walang naka-iskedyul na refresh.

Request

GET
/openapi/v1/balance
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
}