GET /v1/balance

Αυτό το τελικό σημείο μόνο για ανάγνωση επικυρώνει το κλειδί API αλλά δεν απαιτεί θετικό υπόλοιπο.

Αίτηση

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

Απάντηση

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

Για μεμονωμένα διαπιστευτήρια, το υπόλοιπο ανήκει στον χρήστη που κατέχει το κλειδί. Για τα διαπιστευτήρια επιχείρησης, οι χρεώσεις API χρησιμοποιούν πάντα το πορτοφόλι κατόχου της εταιρείας. Το κοινόχρηστο εταιρικό υπόλοιπο επιστρέφεται μόνο όταν ο εντολέας διαπιστευτηρίων έχει ορατότητα υπολοίπου σε επίπεδο εταιρείας (κάτοχος οργανισμού, διαχειριστής ή ρόλος χρέωσης). Τα διαπιστευτήρια προγραμματιστή/θεατή υπαλλήλων ενδέχεται να εκτελούν επιτρεπόμενα αιτήματα API αλλά να λαμβάνουν HTTP 403 από /v1/balance; Αυτοί οι χρήστες βλέπουν μόνο την επιτρεπόμενη χρήση της ομάδας και τα όριά τους στον πίνακα ελέγχου. Κλειδί API usage και spend_limit παραμένουν ξεχωριστές τιμές.

Σφάλμα ελέγχου ταυτότητας

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

Σφάλμα άδειας επιχείρησης

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