API del saldo

Controlla quanti crediti puoi spendere e quanti di essi scadono al prossimo rinnovo mensile.

GET/openapi/v1/balance

Ottieni il saldo

Restituisce il saldo di crediti dell'account proprietario della chiave API. In un team con un pool di crediti condiviso, i valori sono quelli del pool. Chiamare questo endpoint è gratuito.

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
}

Valori restituiti

Name
balance
Type
integer
Description
Numero di crediti che puoi spendere. Di solito è monthly_credits più permanent_credits.
Può essere inferiore quando ti si applica un limite di crediti per membro o un limite di crediti dello spazio di lavoro Enterprise. I proprietari e gli amministratori del team non hanno questo limite.
Name
monthly_credits
Type
integer
Description
Numero di crediti residui che scadono al prossimo rinnovo mensile, in monthly_resets_at.
Name
permanent_credits
Type
integer
Description
Numero di crediti che non scadono, ad esempio quelli derivanti da pacchetti di crediti acquistati o da ricompense.
Name
monthly_resets_at
Type
timestamp
Description
Orario del prossimo rinnovo mensile dei crediti, in millisecondi Unix. A quel momento, i crediti mensili residui scadono e un abbonamento attivo li ricarica. null quando non è previsto alcun rinnovo.

Modalità di errore

Name
401 - Unauthorized
Description
La chiave API è mancante o non valida. Controlla l'header Authorization.
Name
429 - Too Many Requests
Description
Hai inviato troppe richieste. Attendi il numero di secondi indicato in Retry-After, quindi riprova.