lowpoly는 2026. 10. 30.에 지원 종료됩니다. 요청 오류를 피하려면 해당 날짜 전에 모델을 전환하세요. 모든 지원 중단 보기

Balance API

사용할 수 있는 크레딧이 얼마나 남았는지, 그리고 다음 월간 갱신 시점에 그중 몇 개가 만료되는지 확인하세요.

GET/openapi/v1/balance

잔액 조회

API 키를 소유한 계정의 크레딧 잔액을 반환합니다. 크레딧 풀을 공유하는 팀의 경우, 해당 값은 풀의 값입니다. 이 엔드포인트 호출은 무료입니다.

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
}

반환 값

  • Name
    balance
    Type
    integer
    Description

    사용할 수 있는 크레딧 수입니다. 보통 monthly_credits와 permanent_credits를 합한 값입니다.

    멤버 크레딧 한도나 Enterprise 작업 공간 크레딧 한도가 적용되는 경우 더 낮을 수 있습니다. 팀 소유자와 관리자에게는 이러한 한도가 적용되지 않습니다.

  • Name
    monthly_credits
    Type
    integer
    Description

    monthly_resets_at에 다음 월간 갱신 시점에 만료되는 남은 크레딧 수입니다.

  • Name
    permanent_credits
    Type
    integer
    Description

    만료되지 않는 크레딧 수로, 예를 들어 구매한 크레딧 팩이나 보상으로 받은 크레딧이 해당됩니다.

  • Name
    monthly_resets_at
    Type
    timestamp
    Description

    다음 월간 크레딧 갱신 시각으로, Unix 밀리초 단위입니다. 이 시점에 남은 월간 크레딧은 만료되며, 활성 구독이 있는 경우 다시 채워집니다. 예정된 갱신이 없으면 null입니다.

실패 모드

  • Name
    401 - Unauthorized
    Description

    API 키가 없거나 유효하지 않습니다. Authorization 헤더를 확인하세요.

  • Name
    429 - Too Many Requests
    Description

    요청을 너무 많이 보냈습니다. Retry-After에 명시된 초만큼 기다린 후 다시 시도하세요.