Balance API

Prüfen Sie, wie viele Credits Sie ausgeben können und wie viele davon bei der nächsten monatlichen Aktualisierung verfallen.

GET/openapi/v1/balance

Guthaben abrufen

Gibt das Guthaben des Kontos zurück, dem der API-Schlüssel gehört. Bei einem Team mit gemeinsamem Credit-Pool sind dies die Werte des Pools. Der Aufruf dieses Endpunkts ist kostenlos.

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
}

Rückgabewerte

Name
balance
Type
integer
Description
Anzahl der Credits, die Sie ausgeben können. Normalerweise ist dies monthly_credits plus permanent_credits.
Der Wert kann niedriger sein, wenn ein Credit-Limit für Mitglieder oder ein Credit-Limit für Enterprise-Arbeitsbereiche für Sie gilt. Für Team-Inhaber und -Administratoren gilt dieses Limit nicht.
Name
monthly_credits
Type
integer
Description
Anzahl der verbleibenden Credits, die bei der nächsten monatlichen Aktualisierung unter monthly_resets_at verfallen.
Name
permanent_credits
Type
integer
Description
Anzahl der Credits, die nicht verfallen, zum Beispiel aus gekauften Credit-Paketen und aus Belohnungen.
Name
monthly_resets_at
Type
timestamp
Description
Zeitpunkt der nächsten monatlichen Credit-Aktualisierung, in Unix-Millisekunden. Zu diesem Zeitpunkt verfallen die verbleibenden monatlichen Credits, und ein aktives Abonnement füllt sie wieder auf. null, wenn keine Aktualisierung geplant ist.

Fehlerfälle

Name
401 - Unauthorized
Description
Der API-Schlüssel fehlt oder ist ungültig. Überprüfen Sie den Authorization-Header.
Name
429 - Too Many Requests
Description
Sie haben zu viele Anfragen gesendet. Warten Sie die in Retry-After angegebene Anzahl an Sekunden und versuchen Sie es dann erneut.