Balance API
Balance API를 사용하면 계정의 현재 크레딧 잔액을 조회할 수 있습니다. 이 엔드포인트는 다양한 Meshy 서비스에 사용되는 사용 가능한 크레딧을 간편하게 확인할 수 있는 방법을 제공합니다.
GET/openapi/v1/balance
잔액 조회
이 엔드포인트는 인증된 사용자의 현재 크레딧 잔액을 조회합니다.
반환값
현재 크레딧 잔액을 포함하는 객체를 반환합니다. 팀 구성원의 경우, 이 값은 팀의 공유 크레딧 풀을 반영합니다.
- Name
- balance
- Type
- integer
- Description
현재 계정에서 사용 가능한 크레딧 수입니다.
- Name
- monthly_credits
- Type
- integer
- Description
monthly_resets_at에 지정된 다음 월간 갱신 시 만료되는 잔여 크레딧 수입니다.
- Name
- permanent_credits
- Type
- integer
- Description
구매한 크레딧 팩이나 적립된 보상 등 만료되지 않는 크레딧 수입니다.
- Name
- monthly_resets_at
- Type
- timestamp
- Description
다음 월간 크레딧 갱신 시각으로, 밀리초 단위의 Unix 타임스탬프로 표현됩니다. 이 시각에 구독이 활성 상태인 경우 현재 월간 크레딧이 만료되고 다시 채워집니다. 예정된 갱신이 없는 경우
null을 반환합니다.
일반적으로 balance는 monthly_credits + permanent_credits와 같습니다. 호출자에게 멤버 또는 작업 공간 크레딧 한도가 적용되는 경우 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
}