GET /v1/balance

Dieser schreibgeschützte Endpunkt validiert den API-Schlüssel, erfordert jedoch keinen positiven Saldo.

Anfrage

curl https://api.model-gate.com/v1/balance \
  -H "Authorization: Bearer mg_live_..."

Antwort

{
  "object": "balance",
  "currency": "USD",
  "balance": "12.3400000000"
}

Bei Einzelanmeldeinformationen gehört das Guthaben dem Benutzer, der den Schlüssel besitzt. Bei Business-Anmeldeinformationen wird für API-Gebühren immer die Wallet des Firmeninhabers verwendet. Der freigegebene Firmensaldo wird nur zurückgegeben, wenn der Anmeldedaten-Prinzipal über Sichtbarkeit des Saldos auf Unternehmensebene verfügt (Organisationseigentümer, Administrator oder Abrechnungsrolle). Die Anmeldedaten eines Mitarbeiters als Entwickler/Betrachter dürfen zulässige API-Anfragen ausführen, aber HTTP 403 von empfangen /v1/balance; Diese Benutzer sehen in der Systemsteuerung nur die zulässige Gruppennutzung und -beschränkungen. API-Schlüssel usage Und spend_limit bleiben getrennte Werte.

Authentifizierungsfehler

{
  "error": {
    "type": "authentication_error",
    "code": "invalid_api_key",
    "message": "invalid API key"
  }
}

Fehler bei der Geschäftsberechtigung

{
  "error": {
    "type": "permission_error",
    "code": "balance_not_permitted",
    "message": "Company balance is not available for this credential principal."
  }
}