Balance API

Zjistěte, kolik kreditů můžete utratit a kolik z nich vyprší při příští měsíční obnově.

GET/openapi/v1/balance

Získání zůstatku

Vrátí zůstatek kreditů účtu, kterému patří API klíč. V týmu se sdíleným fondem kreditů jsou hodnoty hodnotami tohoto fondu. Volání tohoto koncového bodu je zdarma.

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
}

Návratové hodnoty

Name
balance
Type
integer
Description
Počet kreditů, které můžete utratit. Obvykle jde o součet monthly_credits a permanent_credits.
Může být nižší, pokud se na vás vztahuje limit kreditů člena nebo limit kreditů pracovního prostoru Enterprise. Vlastníci a administrátoři týmu takový limit nemají.
Name
monthly_credits
Type
integer
Description
Počet zbývajících kreditů, které vyprší při příští měsíční obnově, v čase monthly_resets_at.
Name
permanent_credits
Type
integer
Description
Počet kreditů, které nevyprší, například z balíčků kreditů, které jste zakoupili, a z odměn.
Name
monthly_resets_at
Type
timestamp
Description
Čas příští měsíční obnovy kreditů, v unixových milisekundách. V tomto okamžiku zbývající měsíční kredity vyprší a aktivní předplatné je doplní. null, pokud není naplánována žádná obnova.

Chybové stavy

Name
401 - Unauthorized
Description
API klíč chybí nebo je neplatný. Zkontrolujte hlavičku Authorization.
Name
429 - Too Many Requests
Description
Odeslali jste příliš mnoho požadavků. Počkejte počet sekund uvedený v Retry-After a poté zkuste požadavek znovu.