lowpoly 30 अक्टू॰ 2026 को बंद हो जाएगा। अनुरोध त्रुटियों से बचने के लिए इन तारीखों से पहले मॉडल बदल लें। सभी बहिष्करण देखें

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 का योग होता है।

    यह कम हो सकता है जब आप पर कोई सदस्य क्रेडिट सीमा या एंटरप्राइज़ वर्कस्पेस क्रेडिट सीमा लागू होती है। टीम के मालिकों और एडमिन के लिए ऐसी कोई सीमा नहीं है।

  • Name
    monthly_credits
    Type
    integer
    Description

    शेष क्रेडिट की संख्या जो monthly_resets_at पर अगले मासिक रिफ्रेश पर समाप्त हो जाते हैं।

  • Name
    permanent_credits
    Type
    integer
    Description

    उन क्रेडिट की संख्या जो समाप्त नहीं होते, उदाहरण के लिए आपके द्वारा खरीदे गए क्रेडिट पैक से और रिवॉर्ड से।

  • Name
    monthly_resets_at
    Type
    timestamp
    Description

    अगले मासिक क्रेडिट रिफ्रेश का समय, यूनिक्स मिलीसेकंड में। उस समय, शेष मासिक क्रेडिट समाप्त हो जाते हैं, और एक सक्रिय सब्सक्रिप्शन उन्हें फिर से भर देता है। जब कोई रिफ्रेश निर्धारित नहीं है तो यह null होता है।

विफलता के तरीके

  • Name
    401 - Unauthorized
    Description

    API की अनुपस्थित है या अमान्य है। Authorization हेडर जांचें।

  • Name
    429 - Too Many Requests
    Description

    आपने बहुत अधिक रिक्वेस्ट भेज दी हैं। Retry-After में दिए गए सेकंडों की संख्या तक प्रतीक्षा करें, फिर दोबारा प्रयास करें।